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CROSS-REFERENCE TO MICROFICHE APPENDIX 

A portion of the disclosure of this patent document contains material which is 
10 subject to copyright protection. The copyright owner has no objection to the facsimile 
reproduction by anyone of the patent document or the patent disclosure^ as it appears 
in the patent and trademark office patent file or records, but otherwise reserves all 
copyright rights whatsoever. 

BACKGROUND OF THE INVENTION 

15 Field of the Invention 

The present disclosure relates to electronic commerce, more specifically 
electronic storage and retrieval of information. 

Description of the Related Art 

The ordinary paper business card has become ubiquitous worldwide. Social 
20 rituals have even developed concerning the exchange and scrutiny of these small slips 
of cardboard. By some estimates, billions of business cards change hands every day, 
yet the cards themselves have numerous shortfalls. Each business card contains only 
static information on the cardholder, i.e., the person for whom the card was printed 
and whose name is on the card. Business cards must be reprinted every time any 
25 cardholder information (such as a phone number, electronic mail [email] address, or 
title) changes. Business cards consume not inconsequential amounts of space, yet lack 
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an inherent card-to-caid organization. Thus, it can be difficult to retrieve information 
from a stack of cards, especially if that stack numbers in the hundreds or thousands of 
cards. 

Privacy of information is also a growing issue among modem business people. 
5 By definition, the information on a card is public, yet other information (such as a 
mobile or home phone number) is necessarily shared with some acquaintances. In 
such situations, the cardholder or recipient must fumble for a pen and the additional 
data must be dictated and captured. 

Dynamic access to the cardholder by others is not addressed by the prior art 
10 business card, as it only shows static location information as of the last printing of the 
card. Thus, if a business person is based in Huntington, New York but happens to be 
traveling to San Jose, California, that person's business card will not reflect the 
California address or phone numbers. 

Electronic means of capturing and storing conventional business card data are 
15 currently known. Examples of this technology include card scanners, personal digital 
assistant (PDA) devices and related software, electronic address books, commercial 
email programs such as Microsoftt® Outlook having their own electronic address 
books, "smart phones" or PDA/wireless communication device hybrids, Internet (also 
referred to as the World Wide Web, or simply "Web") based contact organizers, and 
20 the like. This technology all suffers from the same limitation in that it generally lacks 
multi-level privacy for users and cardholders, it carmot help locate the cardholder, it 
(generally) lacks the ability to seamlessly export to or import from other database 
systems, and (with the possible exception of some prior art Web-based contact 
organizers) it lacks centralized control and universal access. 

25 What is needed is a widely-accessible electronic service and method for 

organizing contact information entered by cm-dholders, including but not limited to all 
of the information on a standard business card. This service must provide for the 
ability to export data to standard databases. Privacy of information should be 
configurable at an information record and field level by the cardholder so that access 

30 to some records and some fields in all records can be denied to certain people while 
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access to other records and fields is still allowed. A location feature to allow service 
users to determine how to best reach a listed cardholder at a given time is also 
desirable. A dynamic electronic link, such as the well-knovm Internet hyperlink, is 
also needed to connect the recipients of email from a cardholder to the service. 

5 SUMMARY 

In one embodiment of the present invention, an electronic business card (EBC) 
access and organization system operates from a Web-based computer system that 
includes a database and software for managing access, data privacy, and dynamic 
updates. The cardholder database, i.e., the database containing records of each 

10 registered cardholder (or "Member" of the EBC system), is accessible from any Web 
browser coimected to the Internet, Examples of such common Web browsers are 
Microsoft's Internet Explorer and Netscape® Navigator®. In an alternate 
embodiment, the EBC system may be installed behind a conventional network 
"firewall" security device and thus made accessible only to browsers connected to and 

15 authorized to use the intranet defined by and behind the firewall. 

Access to and delivery of contact information in the EBC system is not limited 
to a Web browser interface as commonly known today. Some embodiments of the 
present invention provide multi-mode access interfaces, including but not limited to 
interfaces using voice-controlled and conventional wireless PDA and/or cell phones, 
20 two-way pagers, and wireless access protocol (WAP)-enabled devices. Further 

embodiments of the present invention provide data delivery interface embodiments 
using, for example, the common alphanumeric pager, wireless markup language 
(WML), or voice delivery (e.g., audio playback) systems commonly used in the art. 

Users (those desiring access to one or more cardholder records) are permitted 
25 to search for cardholder information. Access to individual records is controlled at both 
the record level and the field level. Users having certain permissions (set by the 
cardholder) are permitted to read a defined group of records, though not necessarily all 
fields in each record. Thus, a cardholder may make her business information available 
to all users (or all users in a defined group or groups, such as "Aerospace Engineers" 
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or "Family"), but keep certain information, such as her cellular phone number, private 
to all but a few individuals. Access control is implemented, in some embodiments of 
the present invention, with multiple privacy levels for each field, in addition to the 
well-known "public" and "private" levels. In these embodiments, the cardholder can 
5 specify the degree of privacy associated for each field. For example, a cellular phone 
number may be designated as semi-private and thus available to only those defined 
users granted "semi-private" access to the cardholder's data. In an alternate 
embodiment, more than three privacy levels are defined, allowing even more degrees 
of privacy and finer-grained access control, 

1 0 BRIEF DESCRIPTION OF THE DRAWINGS 

The present disclosure may be better understood and its numerous features and 
advantages made apparent to those skilled in the art by referencing the accompanying 
drawings. 

Figure 1 is a high-level schematic of the hardware platform, according to one 
1 5 embodiment of the present invention. 

Figure 2 is a flowchart of the "Search" process, according to one embodiment of 
the present invention. 

Figure 3 A is a screen shot of the Member Login display, according to one 
embodiment of the present invention. 

20 Figure 3B is a screen shot of the Search display, according to one embodiment of 

the present invention. 

Figure 4 is a screen shot of the Card Display screen, according to one embodiment 
of the present invention. 

Figure 5 is a flowchart of the "Become New Member" process, according to one 
25 embodiment of the present invention. 

Figure 6 is a screen shot of the Terms & Conditions display, according to one 
embodiment of the present invention. 
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Figure 7 is a screen shot of the New User data entry display, according to one 
embodiment of the present invention. 

Figure 8 is a screen shot of the Registration Confirmation display, according to 
one embodiment of the present invention. 

5 Figure 9 is a screen shot of the Welcome display, according to one embodiment of 

the present invention. 

Figure 10 is a screen shot of the My ecardfile display, according to one 
embodiment of the present invention. 

Figure 1 1 is a flowchart of the Export process, according to one embodiment of 
1 0 the present invention. 

Figure 12 is a screen shot of the File Maintenance display, according to one 
embodiment of the present invention. 

Figure 13 is a screen shot of the Export display, according to one embodiment of 
the present invention. 

1 5 Figxire 14 is a flowchart of the "Where Am I?" process, according to one 

embodiment of the present invention. 

Figure 15 is a screen shot of the "Where Am I?" display, according to one 
embodiment of the present invention. 

Figure 16 is a flowchart of the signature hyperlink export process, according to 
20 one embodiment of the present invention. 

Figure 17 is a screen shot signature hyperlink export display, according to one 
embodiment of the present invention. 

Figure 18 is a function block diagram of the Boomerang software application, 
according to one embodiment of the present invention. 

25 Figure 19A is a schematic map of some of the database relationships, according to 

one embodiment of the present invention. 

Figure 19B is a schematic map of some of the database relationships, according to 
one embodiment of the present invention. 
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Figure 19C is a schematic map of some of the database relationships, according to 
one embodiment of the present invention. 

The use of the same reference symbols in different drawings indicates similar or 
identical items. 

5 DETAILED DESCRIPTION 
Introduction 

The electronic business card (EBC) access and organization system consists of 
a hardware complex providing the physical interface to the Internet, firewall security, 
web server functionality, data storage, and system redundancy protection. The 
10 hardware is controlled and operated by computer instructions (i.e., software) in 

various forms, including but not limited to microcode, firmware, assembly and other 
high-level language modules. The EBC system is the integration of the hardware and 
software elements to perform the functions and provide the features noted in the 
Summary above. 

15 Hardware Platform 

In one embodiment of the present invention, the EBC access and orgaiuzation 
system (also referred to as ecardfile™, the Hewlett-Packard® product embodying a 
certain aspect of the present invention) is run on 4 N-class Hewlett-Packard 9000 
computers 1 10, as shown in Figure 1 . These computers are configured, in one 

20 embodiment, with 4 Gigabytes (GB) of memory and 4 processors, running the 

HP-UX® operating system version 1 1.0. Other memory/processor/operating system 
configurations are also possible. There are two front-end web servers (1 lOA and 
HOB) talking to a database server (1 IOC) that has access to one or more shared 
automatic redundant arrays of inexpensive disk drives (RAIDs) 120, each RAID 

25 having 64 GB of memory. Warm fail-over server (1 lOD), which uses in one 

embodiment MC-Service Guard™^ a Hewlett-Packard product, protects database 
server HOC. 
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Although an N-class Hewlett-Packard 9000 is described, those skilled in the 
art will realize that servers other than the N-class Hewlett-Packard 9000 can be used. 
Accordingly, the invention is not limited to any particular type or brand of server. 

• Web Servers 

5 The two front-end web servers 1 1 OA and 1 1 OB are served by a two Cisco 

Systems®, Inc. Catalyst™ 5505 switches 130A and 130B, which are served by two 
Cisco Local Director™ units 140A and HOB, which in turn are server by two Cisco 
PDC® Firewall units 15 OA and 150B. The fu-ewall units 150 connect through an 
internet service provider (ISP) local area network (LAN) 160 to the Internet 170. 

1 0 The web servers are running, in one embodiment of the present invention, the 

Stronghold® Apache web server operating program, available from C2Net, Inc. This 
is a 128 bit secured web server. Other commercially-available server operating 
programs are also useable. 

The Local Director units 140 A and 140B load balance the incoming requests 
15 to the two web servers 1 1 OA and 1 1 OB by switching packets in switches 1 30A and 
130B. 

The web content (resident in web servers 1 1 OA and 1 lOB) is dynamically built 
with the aid of server-side Java™ applications known as servlets. The JRun™ servlet 
engine (in one embodiment of the present invention, version 2.3, build 145) executes 
20 these servlets, with the aid of a dynamic loaded module within the Apache web server 
operating program. The servlets are written to conform to the Java Servlet 
Development Kit API v2.1, available from Sun Microsystems, in order to property 
interface vdth the Apache web server software. 

The biggest advantage in using servlets as opposed to other web development 
25 tools is performance. A single Java virtual machme (in one embodiment of the present 
invention, the HP-UX Java Virtual Machine version 1.1.8.1) runs on the server and 
the servlet is loaded once when it is called. It is not loaded again until the servlet 
changes, and a modified servlet can be re-loaded without restarting the server. The 
servlet stays resident in memory and is very fast. Static or persistent information can 

-7- 

578649 v2 

CUent Reference: 10992822-1 



Attorney Docket No. : M-8 1 52 US 



be shared across multiple invocations of the servlet, allowing the sharing of 
information between multiple users. For instance, a single database connection can be 
use by multiple browser requests. 

• Database Server 

5 The database servers 1 IOC and HOD run, in one embodiment of the present 

invention, Informix® Dynamic Server® Version 7.3LUC4. Other database server 
software packages and versions are also useable. Access to the database is via the 
industry standard JDBC applications programming interface (API) and Informix' 
JDBC drivers (in one embodiment of the present invention, driver version 1 .40. JC2). 
10 The use of JDBC ensures scalability and database and platform independence. 

User Interaction 

A user's interaction with the ecardfile EBC system, according to one 
embodiment of the present invention, is illustrated in Figure 2. This flowchart shows a 
typical use of the EBC system to perform a search on cardholder data. Note that, in 
1 5 some embodiments, the user need not be a registered Member of the ecardfile system. 
In an alternate embodiment, only registered Members can use the system. 

Interaction begins at step 200. The user starts a conventional Web browser, 
such as Internet Explorer or Netscape Navigator, 210, and enters the ecardfile 
Uniform Resoxirce Locator (URL) 215. This URL is the Internet address of the EBC 
20 system hardware described above and is defined, disseminated, and maintained 
through means well-known in the art. Upon receipt and processing of the URL by 
Internet 170 (generally speaking), the user's browser is redirected to a secure web site 
218 by conventional techniques common in the art. 

Once connected, ecardfile returns the web browser codes (e.g., HTML) to the 
25 user to display the Member Login screen, shown in one embodiment in Figure 3A. 
The Member Login screen display consists of window 310 containing the ecardfile 
login graphic 320, copyright notice 330 and hyperlinks 340 and 345, to a terms of use 
page and a privacy statement, respectively. 
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In step 230 of Figxire 2, the user selects the "Go" button (350) associated with 
the "View Cards" command in login graphic 320. This selection brings up search 
screen 360 (Figure 3B) in window 3 1 0. In one embodiment of the present invention, 
the user is given the choice 232 of searching by cardholder name 234 or ecardfile ID 
5 number 236, a multi-digit nximber or multi-character alphanumeric value representing 
a cardholder. If the user selects lookup by name, the user is given the further choice 
238 of searching by similar sounding names using, for example, the SoundEx 
software toolbox. In the latter case, the user checks check box 365 to conduct a 
sounds-like search. 

10 The search begins 250 when the user selects the "Go" button 370 or 375 

corresponding to the type of search desired in step 240. The EBC system returns 
results 260 in the Results Screen 410 shown in Figure 4. This screen replaces search 
screen 360 in window 310. 

A user may chose, at step 220 of Figure 2, to become a Member of the 
15 ecardfile user commxmity, rather than performing a search. In this case, the interaction 
follows the flowchart of Figure 5 instead. The process begins in step 501. The user 
starts a Web browser 210 and visits the ecardfile login screen 320 as before (steps 
215, 218, and 220). Here, however, the user selects the "Become New Member" 
button 370 (Figure 3 A) in step 510. 

20 This selection brings up Terms screen 610 (Figure 6) in window 310 (step 

515). The user is then given choice 520 to go back to login screen 320 (which ends the 
"Become New Member" process, step 599) or to continue the process to step 525. 
Choice 520 is implemented, in one embodiment of the present invention, using Back 
button 620 and Continue button 630. 

25 The selection of Continue button 630 brings up, in step 525, New User data 

entry screen 710 in window 310 (shown in Figures 7 A and 7B). The user selects an 
ecardfile ID and password and fills out the personal data using conventional data entry 
means for any of the well-known access devices and systems discussed above, such as 
using a keyboard or a voice-controlled (audio) prompt and response scheme. Privacy 

30 levels 720 are also set by the user for each field in the user (soon-to-be Member and 
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Cardholder) data record. In one embodiment, depicted in Figures 7A and 7B, three 
privacy levels are possible: Private, denoted by the locked padlock icon 722; Semi- 
Private, denoted by the partially-locked icon 724; and Public, denoted by the open 
lock icon 726. Public and Private privacy levels represent the familiar "all access" and 
5 "no access" privacy settings known in the art. Semi-Private privacy represents a level 
of access granted only to certain members of the public, such as a predefined group of 
users designated by the Member or by a EBC system administrator. Non-designated 
users do not have access to Semi-Private fields. 

Although a three-level (Private, Semi-Private, and Public) privacy scheme is 
10 described, those skilled in the art will realize that privacy (or security) schemes 

implemented in more than three levels can be used. For example, a variety of different 
user groups can be defined with exclusive Semi-Private access given to some groups 
over others on a field-by-field basis. Accordingly, the invention is not limited to any 
particular number of privacy levels. 

1 5 Once all requested information has been entered (or left blank, where optional 

as defined by the EBC system), the user chooses to continue or not at step 535. If the 
user decides not to continue by pressing Cancel button 740 (Figure 7B) , the process 
ends at step 599. If, however, the user chooses Okay button 730, the system displays a 
Registration Confirmation page 810 (Figure 8) in window 310. Here the user is given 

20 the choice 545 to accept the terms of use of the EBC system (via Accept button 820) 
or to go back (via Back button 830) to step 530 to edit personal data or enter 
additional data. 

If the user accepts the terms of use, and email message is automatically 
dispatched 550 by the EBC system to the new Member's designated authorizing email 
25 address (field 750 in Figure 7B). A welcome screen 910 (Figure 9) is then displayed to 
the new Member, step 560, in window 310. 

Meanwhile, the user (now a Member) receives an authorization email message 
by conventional means. In one embodiment of the present invention, such an email 
message is as shown in Table 1 below. This email authorization method provides a 
30 measure of additional security by ensuring that each Member is associated with a valid 

- 10- 

578649 v2 

Client Reference: 10992822-1 



Attorney Docket No. : M-8 1 52 US 



email address. The email address is also used to verify a user identity in case of a lost 
password: on the user's request, the password will be sent to the authorized email 
address only. 

When the user selects the embedded hyperlink (in this example, the string 
5 beginning http://ec^rd file, com,,,) in step 570, the EBC system directs the 
Member (in step 580) to home page 1010 in window 310 (Figure 10) . In some 
embodiments (not shown), home page 1010 is personalized with Member data, such 
as the Member's name. 



10 



15 



20 



25 



Table 1 



Welcome! You have been added as a new Member of ecardfile.com. To 
activate your password, please click on the Web address below: 

http ://ecardflle, com/search?op=Confi2nn&eCardId=te2rry&createId=0Av4Jj 6 
nWZwA4 

You can also type the above Web address into your Web browser. 

Once you have connected to the ecardfile.com site through the above 
address, your password activation is complete, and you can begin to 
enjoy the ease and convenience of having your business contact 
information on the Web. 

If you do not connect to ecardfile.com through the above address 
within two weeks, your card will be deactivated. 

We look forward to having you as an ecardfile.com Member! 

webmaster@ecardf ile . com 



30 

Export Process 

Figure 1 1 shows the process whereby a user is able to export card data to a 
file. As above, the user must first login to ecardfile.com. At step 1610, the user selects 
file maintenance button 394. A user file maintenance screen (Figure 12) is then 
35 displayed, step 1620. The user selects a card to export, step 1630, fi*om the list of 
cards added by the user to his/her private list. These cards represent other users to 
whom the user has granted extra privileges. Non-member users do not have export 
privileges. Of course, only the information to which the user has been granted access 
is exported. 
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The user next selects the export button 1710 (Figure 12) in step 1640, which 
brings up an export options screen, shown in Figure 13. The user selects the desired 
output format, step 1660, and is presented with a conventional "Save As" dialog, step 
1670. The user enters a name of the file into which the card export will be saved, step 
5 1680 and selects the Save button, step 1685. If Save is selected, the data will be saved 
by conventional means in step 1687. If not, as when the user selects "Cancel" instead, 
the process drops to the end state, step 1690, and returns to waiting for user input. 

The exported card is formatted into a pre-defined data file structure readable 
by one or more conventional and commercially-available contact management 
10 programs. In some embodiments, custom export file formats may also be defined by 
the user to provide even wider connectivity and cross-platform utility. 

''Where Am I?" Contact Location Tracking 

The process of setting up a temporary location pointer for a specific 
Cardholder/Member begins in step 1110 of Figure 14. As before, the Member sets his 
] 5 or her browser to the appropriate EBC system URL and connects to the system, steps 
210, 215, 218, and 220. The Member then logs in, step 1 120, and is displayed home 
page 1010 (Figure 10) in step 1130. 

The Member then selects an icon or button denoting the function "Edit My 
Card." In one embodiment of the present invention, this function is iconified in button 
20 395. In response, the EBC system displays (step 1 140) a user information screen (not 
shown) in window 3 1 0. The Member there selects a button denoting the fimction 
"Where Am I?" in step 1 1 50. 

At this point (step 1 160), the EBC system displays "Where Am I?" screen 
1210 (Figxire 15) in wdndow 310 thereby prompting the Member for a phone number 
25 and additional details of the Member's location, step 1 165. This information also 
includes an expiration date, i.e., a date beyond which the "Where Am I?" data is no 
longer valid. 

To exit the "Where Am I?" information dialog, the Member clicks Okay 
button 1220 (step 1 167), to save the "Where Am I?" data, or the Back button 1230 to 
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cancel "Where Am I?" data input. The process returns to a display of the user 
information screen, step 1 140, and stops, step 11 99. 

Signature Hyperlinking 

The process of exporting a signature hyperlink, shown in Figure 16, is almost 
5 the same as that of exporting a card, except that the user selects the My Card button 
395 rather than the file maintenance button 394. The options screen, shown in 
Figure 17, is presented at step 1820. The output of the process, step 1830, is a file 
containing either a hyperlink or a conventional vCard file, as selected firom the options 
display of Figure 17. 

10 Either the signature hyperlink or the vCard (which can also contain a 

hyperlink) can then be used by conventional email programs. Electronic mail sent by 
the cardholder is automatically formatted to contain a signature hypertext link, 
according to the well-known hypertext markup language (HTML) standard or any of 
its conmion variants, directing recipients of the email to the electronic business card 

15 access and organization system. This hyperlink enables the recipient of the email to 
rapidly access the EBC system to locate the cardholder and/or obtain additional 
information. In effect, receipt of an email containing the hyperlink enables the 
recipient to easily become a user. In some embodiments, the signature hyperlink is 
part of the vCard feature known and implemented in common email programs such as 

20 Microsoft Outlook and Netscape Communicator®. In an alternate embodiment, the 
signature hyperlink is implemented using the well-known email signature block 
feature. 

ecardfile Help Screens 

The following topics are the subject of individual help screens, available to 
25 any EBC system user or Member by pushing (in some embodiments of the present 
invention) the Question Mark ("?") button 390, shown in, e.g.. Figure 3A. The 
contents of these help screens are reproduced below as an aid to understanding the 
EBC system. 

• Become a Member 

- 13- 

578649 v2 

Client Reference: 10992822-1 



Attorney Docket No.: M-8 1 52 US 



• Set up your card 

• Set up "Where Am I?" 

• Add others' cards to your ecardfile 

• Exchange cards with others 
5 • Set/change privacy levels 

• Export cards to your address book 

• Set up your email signature 

• Contact ecardfilexom support 

• Become a Member 

10 As an ecardfile Member, you set up your own Card Profile and establish your 

own unique Card ID and Password. Then, whenever you log in, you are located at 
your personal ecardfile and can view cards fi-om other Members and add them into 
your ecardfile. 

Let's walk through the process of becoming a Member. 

15 1 . From the Member login screen, click the Become a Member button. 

2. Fill in your Card Profile: the profile contains all of your contact information 
and can be updated as needed. See the help menu topic "Set Up Your Card" 
for more information. 

After your membership is confumed, you can log in to ecardfile.com using 
20 your Card ID and password. After log in, you are brought to yom personal ecardfile 
area. Here is where you can store other Member cards and perform fimctions such as 
adding, deleting, changing the privacy level access to yom Card that you have given to 
other Members, and exporting a card to your address book. 

It's a good idea to keep your "Where Am I?" information current. To access it, 
25 click on the My Card Profile icon and scroll to the bottom of the screen. 
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The more people you know who join ecardfile.com, the easier it is to use this 
convenient way to access business information. To help get the word out, please 
download your personal email signature or vCard (accessible from the export button 
at the bottom of your Card Profile) and attach it to all your emails. When people 
receive email fi-om you, they can click on yoxir signature link and go directly to your 
Card Profile in ecardfile.com. From there, they can also choose to become ecardfile 
Members, if they are not Members already. 

• Set Up Your Card 

When filling in your Card Profile, please keep a few concepts in mind: When 
selecting your Card ID, use up to 40 alphanumeric characters. Because you will be 
giving out this ID to your business and personal contacts, make your ID simple and 
easy to remember; it's use is similar to that of your email usemame. Although 
ecardfile.com also enables you to be looked up through a first name/last name search, 
it will usually be much faster for people to look you up by your Card ID. 

When selecting your password, use up to 10 alphanumeric characters. Make 
your password something easy for you to remember and hard for others to guess. 

As you are entering information into your Card Profile, please keep in mind 
that ecardfile.com gives you three levels of privacy for each field: 

Level 1 - Public . Information at this level will be displayed to anyone who 
looks up your card. This could be anyone viewing cards firom the World Wide Web, 
whether you know them or not. 

Level 2 - Semi-Private . Information at this level will displayed only to other 
ecardfile Members who are in your personal ecardfile and who have been designated 
to receive your semi-private information. 

Level 3 - Private . Information at this level will displayed only to other 
ecardfile Members who are in your personal ecardfile and who have been designated 
to receive yoxor private information. 
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All field information is set to private when you first fill out a Card Profile. Be 
sure to select other privacy levels for fields that are either semi-private or public. 

The Email Auth field is used only by ecardfile.com for verification purposes. It 
is never displayed on your Card, You must enter a current email address in the Email 
5 Auth field. Once you complete the Card Profile and click "OK," ecardfile sends an 
email to this address and waits for your reply before authorizing your membership and 
enabling you to log in. This authorization process has been designed to protect your 
privacy and identity. 

• Add others ' cards to your ecardfile 

10 From your personal ecardfile screen, use the Look Up fields to view the card 

of the Member you want to add. When the card is displayed, press the Add icon. 

If you would like to give this Member access to your semi-private or private 
ecardfile information, be sure to change the privacy level displayed next to the 
Member's name. See the help topic "Set/change privacy levels" for more information. 

15 * Exchange cards with others 

In order to protect your privacy, ecardfile.com offers several ways you can 
exchange cards with others. 

• Anyone, whether they know you or not, can look you up by name and see the 
information designated as "public" in your Card Profile. Note: for this reason, 

20 you may decide not to have yoxir email addresses be part of yom public 

information. 

• Casual or new acquaintances can look you up by name search or by Card ID 
and see the information designated as ''public" in your Card Profile. 

• Members can look you up by name search or Card ID and see the public, semi- 
25 private or private information you have specifically designated for them. 
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For example, let's say a new person, Hans, has joined your project team; he 
works out of your company's Munich office, and you are in Los Angeles. Hans is not 
yet a Member of ecardfile.com. 

1 . At the initial team conference call, you give Hans your Card ID and tell him 
that's where all your contact information is. 

2. Hans accesses ecardfile.com and becomes a Member. He looks up your Card 
and adds it to his personal ecardfile. He wants you to have his semi-private 
information so he marks your card with the semi-private access key. 

3. You look up Hans's card and add it to your personal ecardfile. You then mark 
Hans' s card with the semi-private access key so that he can see more detailed 
information about you than what appears on your public card. 

4. Over the next 6 months, Hans changes office locations and gets a new phone 
number; your fax nximber changes, and the Post Office gives your part of town 
a new zip code. Thanks to ecardfile.com, your contact information is always 
current. 

0 Set Up " Where Am I? " 

From your Card Profile, scroll to the bottom of the screen and click on "Where 
Am I?" You'll have the option to input a current phone number, details about your 
whereabouts, and an expiration date. Note that you can specify different privacy levels 
for the phone number, details and expiration fields, so you might want your phone 
number to be public, while the details of where you are remain private. To see another 
Member's "Where Am I?" information, select her card from your personal ecardfile or 
look up her card. When the card is displayed, scroll to the bottom of the screen and 
cUck on "Where Am I?" 

The expiration date uses the date at the ecardfile server's location, US Pacific 
Standard Time (PST). The expiration date is customizable to the ecardfile Member's 
own location. 
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• Set up your email signature 

Use this function to download a signature file or a vCard from ecardfile.com to 
your email system. Access it by going to your Card Profile, scrolling to the bottom of 
the screen, and clicking on Export. Then follow the instructions on the screen to 
export to your particular email system. 

A signature file has an HTML link to your Card; when downloaded, the 
signature file will embed the link into all of your email messages. When someone 
reads your message and wants to view your contact information, he just clicks on the 
HTML link and is immediately connected to your Card and your up-to-the-minute 
contact information. 

A vCard is a file that holds your contact information in a standard format. 
Some email packages such as Microsoft Outlook and Netscape Communicator 
recognize this format and can treat it in a special way. Because it is not a live link, it 
may display old or inaccurate information, particularly if someone is reading an old 
email message from you. 

If your email package, or more importantly the message recipient's email 
package, does not support HTML tags or vCards, you may cut and paste the HTML 
link displayed and attach it to your messages. The recipient just clicks or cut and 
pastes the HTML link into a browser and is immediately connected to your Card and 
your up-to-the-minute contact information. 

• Export cards to your address book 

Use this function to download cards firom your personal ecardfile to your email 
address book. 

1 . Go to your personal ecardfile. 

2. Select the card for export by placing a check mark next to it. 

3 . Click on the maintenance button. 

4. Select export. 
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5. Select the format of your address book, 

6. Follow the online instructions to export the card information. 

• Contact ecardfile, com support hyperlink 

Here, an email window automatically pops up if this link is selected, and 
5 ecardfile.com' s technical support address is automatically inserted into the "To" field. 

• Get help on a specific screen, field or icon 

To get help on a specific screen or field, place the mouse arrow on the gray bar 
of the screen and press the "Help" key on the keyboard. 

To get help on a specific icon, pass the mouse over the icon, and the icon title 
10 will display. 

One of ordinary skill in the art will appreciate that many other methods of 
activating context sensitive help are known in the art; the present disclosure is 
intended to encompass all such well-known methods and is not limited to any single 
form. 

15 * Set/Change privacy levels 

ecardfile.com gives you two ways to control who sees what information about 
you: You can designate each field in your Card Profile with a specific privacy level 
that governs private, semi-private or public viewing of that field. Alternatively, you 
can specify which Members have access to which level of privacy about you. If a 
20 particidar Member has access to your semi-private information, he or she v^U see all 
of the fields marked public or semi-private when viewing your card. 

• Designate Your Card Profile privacy: 

To change privacy levels on a field in your Card Profile (for example, to make 
your business email address, which had been public, semi-private) click on the My 
25 Card Profile icon and then click the appropriate new privacy button next to the email 
address field. A public field has the open padlock icon selected. A semi-private field 
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has the partly-open padlock icon selected. A private field as the closed padlock icon 
selected. 

# Specify Member privacy: 

Let's say you want to give your new manager access to yoxor private 
information. 

1 . From your personal ecardfile, look up your manager's card and add it to your 
file, 

2. Select the card for maintenance by placing a check mark next to it. 

3. Click on the Maintenance button. 

4. Select Edit Privacy. 

5. Select the new privacy level you want your new manager to have about you. 

6. Select Update to save the new privacy level. 

Now, whenever your new manager accesses your Card, she will see all 
information you have designated as public, semi-private and private. 

Software Implementation 

In one embodiment of the present invention, the controlling software 
application providing some of the EBC system fimctionality is called Boomerang. The 
Boomerang application has five major components, shown schematically in Figure 18: 

1 . Session Manager daemon 1310, which maintains state information; 

2. Login Servlet 1320, which handles user/Member authentication; 

3. Search Servlet 1330, which handles most of the user/Member interface 
functionality; 

4. JDBC Objects/Classes 1340, which implement the database functionality; and 

5. HTML Template Engine, which handles conventional dynamic HTML 
processing. This component is typically implemented in Java and reads HTML 
tagged files. 
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Boomerang is designed to scale and perform well under extreme loads. It is 
designed to operate on multiple processors simultaneously, i.e., with multiple 
instances of objects and methods. Multiple Web servers and Java virtual machines 
may be used as server loading and traffic demands. 

5 In one embodiment of the present invention, most of the Boomerang 

application, Web server 1360 (in one embodiment of the present invention, 
Stronghold Apache), JRun Servlet Engine 1370, and a Remote Memory Invocation 
(RMI) registry will run on each of the two Web server machines 11 OA and HOB 
(Figure 1). The JRun Servlet Engine 1370, and RMI registry are common Java 
1 0 objects; the RMI API allows a servlet to invoke the methods of a Java object 

executing on another machine. The Session Manager 1310, another RMI registry, and 
the Informix database software 1380 will run on one of the databases servers 1 IOC or 
HOD, the other database server acting as a warm fail-over device. 

• Software Components 

1 5 In the following discussion, the terms "Member" and "user" are used 

interchangeably to refer to a person who has established a login identify in the EBC 
system. Strictly speaking, however, a Member is a person who has completed the New 
Member process and properly replied to the authorization email; user is a person who 
has not. 

20 • Session Manager 1310 

When the system is first accessed, a session will be created. This session will 
be identified by a unique session ID. This ID will be used for the following tasks. 

Once a user has successfully logged in, the session ID will make a record of 
this fact so that when a user returns to a page that requires user authentication or 
25 identification, the user will not be re-prompted to login. The session ID will be passed 
fi:om Web page to page as either a hidden field in a form or by rewriting the URL, 
both well-known techniques in the art. Alternatively, the user may be given the option 
of saving authentication information in a local file, known in the art as a cookie. The 
system will check for this cookie prior to displaying the login page. 
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The session ID will expire if it has not been accessed in a time configured by 
the EBC system administrator. 

• Login Servlet 1320 

This servlet is activated w^hen a function requiring user authentication is called 
5 and the user has not yet logged in. The login screen is shown and user name and 
password input received. The input name and password are matched against a users 
table. If the user name is found and the proper password supplied, the request (and 
session ID, if present) is passed to the Search Servlet. 

• Search Servlet 1330 

1 0 The Search Servlet requests a session ID if one was not passed to it, or 

validates the ID if one was passed. If the requested operation requires user 
authentication and the user has not already logged in, the Login Servlet is called. All 
URL and form parameters are passed to the application logic of the servlet for 
processing. 

1 5 After processing the URL and form parameters, a HTML document (e.g., a 

results screen) is returned to the requestor, typically the browser window. 

0 JDBC Objects/Classes 1340 

These consist of generic JDBC classes that execute queries and return results 
in a Java hash table indexed by column name. To make more efficient use of database 
20 resources, all structured query language (SQL) statements are prepared at servlet 
initialization. 

Also at servlet initialization, database connection pool 1390 creates a number 
of connections to the database, the precise number of which is configurable by the 
EBC system administrator. These connections are utilized by each servlet thread on an 
25 as-needed basis. Additional connections are created as demand requires; inactive 
connections are periodically recycled. 
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• HTML Template Engine \ 

All pages displayed by the Boomerang application, including the help and 
information screens, are dynamically generated. The base HTML code and image 
links for these pages are stored as template files which are preloaded on servlet 
initialization. These files are parsed and custom tags replaced with data extracted from 
the database (or calculated) before sending the page to the requestor and display to the 



user. 



# Adm inistration Programs 

In addition to the Boomerang application, the EBC system also includes a set 
1 0 of shell and SQL scripts that operate on a periodic basis (i.e., are activated by cron) 
to perform housekeeping and maintenance tasks. In particular, the following program 
fimctions are required. 

a) Purge inactive users who have not activated themselves via the login email 
after a defined period of time, for example one month 

1 5 b) Expire "Where Am I?" temporary contact information 

c) Lock and unlock IP addresses (to prevent access by IP addresses tiiat appear to 
be attempting to access the service for illicit purposes) 

d) Rollover logs and reports 

One of ordinary skill in the art will recognize that these fimctions may be 
20 implemented in a single program or script or in a set of programs and/or scripts. 

Accordingly, the present invention is not limited by the method of implementation of 
these functions. 

# Database Schema 

Figures 19 A, 19B, and 19C illustrate the database structure and one-to-many 
25 /one-to- one relationships between records and fields in one embodiment of the 
present invention. In particular, relationship symbol 1410 denotes a one-to-many 
correspondence, the "one" side represented by the sign end. See Figure 19A for an 
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example. Relationship symbol 1420 (see Figure 19B) denotes a one-to-one mapping, 
the "one" side again represented by the ' sign end. 

The notations PK, FKl, and II - 15 represent SQL field labels. SERIAL, in 
particular, is a well-known data type. 

5 Although a particular database schema and naming convention for records and 

fields is described, those skilled in the art will realize that schema other than that 
described can also be used. Accordingly, the invention is not limited to any particular 
type of database schema. 

Alternate Embodiments 

10 In an alternate embodiment, the EBC system may be installed behind a 

conventional network "firewall" security device and thus made accessible only to 
browsers connected to and authorized to use the intranet defined by and behind the 
firewall. 

Access to and delivery of contact information in the EBC system is also not 
1 5 limited to a Web browser interface as commonly known today. Some embodiments of 
the present invention provide multi-mode access interfaces, including but not limited 
to interfaces using voice-controlled and conventional wireless PDA and/or cell 
phones, two-way pagers, and vdreless air protocol (WAP)-enabled devices. 

Fxjrther embodiments of the present invention provide data delivery interface 
20 embodiments using, for example, the common alphanumeric pager, wireless markup 
language (WML), or voice delivery (e.g., audio playback) systems commonly used in 
the art. 

The EBC system also provides an advanced search fimction that allows users 
to search for records matching specific, desired characteristics. The search can be 
25 made based on one or more of a variety of database parameters, including but not 

limited to field value (e.g., NAME = Sheehy), date of entry, or a Boolean combination 
of search terms. 
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In an alternate embodiment of the "Where Am I?" location tracking feature, 
the cardholder can rapidly designate one of a pre-defmed set of contact locations 
described by meatspace address, phone number, FAX number, and/or email address. 

The order in which the steps of the processes depicted above are performed is 
5 purely illustrative in nature. In fact, the steps in each process flow can be performed in 
any order or in parallel, unless otherwise indicated by the present disclosure. 

The method of the present invention may be performed in either hardware, 
software, or any combination thereof, as those terms are currently known in the art. In 
particular, the present method may be carried out by software, firmware, or microcode 

10 operating on a computer or computers of any type. Additionally, software embodying 
the present invention may comprise computer instructions in any form (e.g., source 
code, object code, or interpreted code) stored in any computer-readable medium (e.g., 
ROM, RAM, magnetic media, punched tape or card, compact disc (CD) in any form, 
DVD). Furthermore, such software may also be in the form of a computer data signal 

1 5 embodied in a carrier wave, such as that found within the well-known Web pages 
transferred among computers connected to the Intemet. Accordingly, the present 
invention is not limited to any particular platform, unless specifically stated otherwise 
in the present disclosure. 

While particular embodiments of the present invention have been shown and 
20 described, it will be apparent to those skilled in the art that changes and modifications 
may be made without departing from this invention in its broader aspect and, 
therefore, the appended claims are to encompass within their scope all such changes 
and modifications as fall wdthin the true spirit of this invention. 

Trademark Notices 

25 Cisco Systems and FIX are registered trademarks and Catalyst, Local Director 

are trademarks of Cisco Systems, Inc., San Jose California. 

Hewlett-Packard and HP-UX are registered trademarks and MC-Service Guard 
and ecardfile are trademarks of the Hewlett-Packard Company, Palo Alto, California. 
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Informix is a registered trademark and Informix Dynamic Server is a 
trademark of Informix Software, Menlo Park, California. 

Java is a trademark of Sun Microsystems, Inc., Palo Alto, California. 

JRun is a trademark of Allure Corp., Cambridge, Massachusetts. 

Microsoft is a registered trademark of Microsoft Corp., Redmond, 
Washington. 

Netscape, Netscape Navigator, and Netscape Communicator are registered 
trademarks of Netscape Communications Corp., Moimtain View, California. 

Stronghold is a registered trademark of C2Net, Inc., Oakland, California. 
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CLAIMS 

We claim: 

1 . A method of providing access to a collection of electronic business 
cards comprising the steps of: 

5 providing an electronic business card file Web site to a user; 

allowing the creation of an electronic business card file by the user using said 
Web site, said creation comprising: 

allowing the user to enter information into a plurality of fields; 
storing said information; and 
] 0 sending an authentication email to the user, wherein a reply to said 

authentication email is required to complete said creation; 
allowing the user to search for one or more records; 
allowing the user to view said records; and 

if said creation is completed, allovdng the setting of privacy levels by the user 
1 5 for each said field, said setting comprising selecting one of more than 

two privacy levels. 

2. The method of Claim 1 , wherein said electronic business card file Web 
site is accessible fi*om the Internet. 

3. The method of Claim 1, wherein said electronic business card file Web 
20 site is accessible from an intranet isolated from the Internet by a firewall seciarity 

device. 

4. The method of Claim 1, wherein said electronic business card file Web 
site is accessible from a web browser. 

5. The method of Claim 1, wherein said electronic business card file Web 
25 site is accessible from a personal digital assistant. 
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6. The method of Claim 1, wherein said electronic business card file Web 
site is accessible from a browser-enabled telephone. 

7. The method of Claim 1 , wherein said electronic business card file Web 
site is accessible by spoken conmiands. 

5 8. The method of Claim 1 , wherein said first format comprises audio 

playback. 

9. A computer system for providing access to a collection of electronic 
10 business cards, comprising computer instructions for: 

providing an electronic business card file Web site to a user; 
allowing the creation of an electronic business card file by the user using said 
Web site, said creation comprising: 

allowing the user to enter information into a plurality of fields; 
] 5 storing said information; and 

sending an authentication email to the user, wherein a reply to said 
authentication email is required to complete said creation; 
allowing the user to search for one or more records; 
allowing the user to view said records; and 
20 if said creation is completed, allowing the setting of privacy levels by the user 

for each said field, said setting comprising selecting one of more than 
two privacy levels. 

10. The computer system of Claim 9, wherein said electronic business card 
file Web site is accessible from the Intemet. 

25 11. The computer system of Claim 9, wherein said electronic business card 

file Web site is accessible fi:om an intranet isolated from the Intemet by a firewall 
security device. 
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12. The computer system of Claim 9, wherein said electronic business card 
file Web site is accessible from a web browser. 

13. The computer system of Claim 9, wherein said electronic business card 
file Web site is accessible fi-om a personal digital assistant. 

5 14. The computer system of Claim 9, wherein said electronic business card 

file Web site is accessible from a browser-enabled telephone. 

15. The computer system of Claim 9, wherein said electronic business card 
file Web site is accessible by spoken commands. 

1 6. The computer system of Claim 9, wherein said first format comprises 
10 audio playback. 



17. A computer-readable storage medixim, comprising computer 
instructions for: 

15 providing an electronic business card file Web site to a user; 

allowing the creation of an electronic business card file by the user using said 
Web site, said creation comprising: 

allowing the user to enter information into a plurality of fields; 
storing said information; and 
20 sending an authentication email to the user, wherein a reply to said 

authentication email is required to complete said creation; 
allowing the user to search for one or more records; 
allowing the user to view said records; and 

if said creation is completed, allowing the setting of privacy levels by the user 
25 for each said field, said setting comprising selecting one of more than 

two privacy levels. 
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18. The computer-readable storage medium of Claim 17, wherein said 
electronic business card file Web site is accessible from the Internet. 

19. The computer-readable storage medium of Claim 17, wherein said 
electronic business card file Web site is accessible from an intranet isolated from the 

5 Internet by a firewall security device. 

20. The computer-readable storage medium of Claim 17, wherein said 
electronic business card file Web site is accessible from a web browser. 

21 . The computer-readable storage medium of Claim 17, wherein said 
electronic business card file Web site is accessible from a personal digital assistant. 

1 0 22. The computer-readable storage medium of Claim 1 7, wherein said 

electronic business card file Web site is accessible from a browser-enabled telephone, 

23. The computer-readable storage medium of Claim 17, wherein said 
electronic business card file Web site is accessible by spoken commands. 

24. The computer-readable storage medium of Claim 17, wherein said first 
15 format comprises audio playback. 



25. A computer data signal embodied in a carrier wave, comprising 
computer instructions for: 
20 providing an electronic business card file Web site to a user; 

allowing the creation of an electronic business card file by the user using said 
Web site, said creation comprising: 

allowing the user to enter information into a plurality of fields; 
storing said information; and 
25 sending an authentication email to the user, wherein a reply to said 

authentication email is required to complete said creation; 
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allowing the user to search for one or more records; 
allowing the user to view said records; and 

if said creation is completed, allowing the setting of privacy levels by the user 
for each said field, said setting comprising selecting one of more than 
two privacy levels. 

26. The computer data signal of Claim 25, wherein said electronic business 
card file Web site is accessible from the Internet. 

27. The computer data signal of Claim 25, wherein said electronic business 
card file Web site is accessible fi*om an intranet isolated from the Internet by a firewall 
security device. 

28. The computer data signal of Claim 25, wherein said electronic business 
card file Web site is accessible fi-om a web browser. 

29. The computer data signal of Claim 25, wherein said electronic business 
card file Web site is accessible from a personal digital assistant. 

30. The computer data signal of Claim 25, wherein said electronic business 
card file Web site is accessible firom a browser-enabled telephone. 

3 1 . The computer data signal of Claim 25, wherein said electronic business 
card file Web site is accessible by spoken commands. 

32. The computer data signal of Claim 25, wherein said first format 
comprises audio playback. 
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E-SERVICE TO MANAGE CONTACT INFORMATION WITH 

PRIVACY LEVELS 

James G. Douvikas 
Terry R. Sheehy 
5 Chris W. T. McKay 



ABSTRACT OF THE DISCLOSURE 

A method of providing an electronic business card (EBC) access and 

1 0 organization service on the Web. The cardholder database is accessible and searchable 
from any browser connected to the Internet or the EBC service may be installed 
behind a conventional firewall and thus accessible only to intranet users. The service 
thus provides easy access to cardholder contact information with privacy assured by 
use of integrated access restrictions. Access to and delivery of contact information by 

15 the service is not limited to a Web browser interface as conmionly known today. The 
service provides multi-mode access and/or data delivery interfaces. The service also 
provides an export feature that formats search results into a pre-defined file structure 
readable by a conventional contact management programs. Custom export file formats 
may also be defined provide even wider connectivity and cross-platform utility. 

20 Access to individual records is controlled at both the record level and the field level, 
with multiple privacy levels for each field, in addition to the well-known "public" and 
"private" levels. Users having certain permissions are permitted to read a defined 
group of records, though not necessarily all fields in each record. A location tracking 
feature is also provided to allow the cardholder to rapidly designate a pre-defined 

25 contact location. Alternately, the cardholder may define a temporary contact location 
not normally stored in the database system. Electronic mail sent by the cardholder is 
automatically formatted to contain a signature hypertext link directing recipients of 
the email to the EBC service. This hyperlink enables the recipient of the email to 
rapidly access the EBC system to locate the cardholder and/or obtain additional 

30 information. 
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PK 


lookupid 


SERIAL 




category 
description 

vcard label 


SMALUNT 
VARCHAROO) 

VARCHAROO) 















PK,FK1 


usersid 


SERIAL 




ecardid 


CHAR(W) 




epassword 


CHAR(IO) 




emaiiauth 


VARCHAR(100) 




titie 


VARCHAR(IO) 




pvttitle 


SMALLINT 




firstname 


VARCHAR(30) 




pvtfirstname 


SMALLINT 




middlename 


VARCHAR(30) 




pvtmiddlename 


SMALLINT 




iastname 


VARCHAR{30) 




pvtlastname 


SMALLINT 




suffix 


VARCHAR(IO) 




pvtsuffix 


SMALLINT 




companyname 


VARCHAR(50) 




pvtcompanyname 


SMALLINT 




jobtitie 


VARCHAR(50) 




pvtjobtitle 


SMALLINT 




businesscomment 


VARCHAR(IOO) 




pvtbusinesscomment 


SMALLINT 




webpageuri 


VARCHAR(IOO) 




pvtwebpageurl 


SMALLINT 




attfirstname 


VARCHAR(30) 




pvtaltfirstname 


SMALLINT 


11 


ecardidjc 


CHAR(14) 


i2 


firstnamejc 


VARCHAR{30) 


13 


lastnamejc 


VARCHAR(30) 


14 


altfirstnamejc 


VARCHAR(30) 


15 


soundex 


CHAR(4) 









PK 


privatelistid 


SERIAL 


i1 

FK1,I1 


cardid 

privatelistusersid 
pvtmask 


INTEGER 
INTEGER 
SMALLINT 



•If- 





ifefep.ecsonanist ■ -k. 




PK 


personallistid 


SERIAL 




FK2,I2 
FK1,12J1 


cardid 

personallistusersid 


INTEGER 
INTEGER 





PK 


bannerid 


SERIAL 




htmlstring 


NVARCHAR(200) 







PK 


lockedipid 


SERIAL 




dateofiock 


CHAR(16) 

DATE 



r,6,. nc 







PK 


iuserid 


SERIAL 




dateofentry 


DATE 


U1 


sessionid 


CHAR(15) 




ecardid 


CHAR(2A3) 




epassword 


CHAR(10) 




cmatlauth 


VARCHAR(100) 




title 


VARCHAR(IO) 




pvttitle 


SMALLINT 




flrstname 


VARCHAR(30) 




pvtfirstname 


SMALLINT 




middlename 


VARCHAR(30) 




pvtmiddlename 


SMALLINT 




lastname 


VARCHAR(30) 




pvtlastname 


SMALLINT 




suffix 


VARCHAR(IO) 




pvtsuffix 


SMALLINT 




companyname 


VARCHAR(50) 




pvtcompanyname 


SMALLINT 




jobtitle 


VARC H AK(50} 




pvtjobtrtJe 


SMALLINT 




businesscomment 


VARCHAR(IOO) 




pvtbusinesscomnnent 


SMALLINT 




webpageuri 


VARCHAR(IOO) 




pvtwebpageuri 


SMALLINT 




altfirstname 


VARCHAR(30) 




pvtaltfirstname 


SMALLINT 




soundex 


CHAR(4) 



-If • 



PK tAddressid 



FK1 



optaddresstype 

streetlinel 

pvtstreetlinel 

streetline2 

pvtstreetline2 

streetline3 

pvtstreetline3 

city 

pvtcity 

stateprovince 

pvtstateprovince 

zip postal 

pvtzippostal 

country 

pvtcountry 

taddressuserid 



SERIAL 



SMALLINT 

VARCHAR(50) 

SMALLINT 

VARCHAR(50) 

SMALLINT 

VARCHAR(50) 

SMALLINT. 

VARCHAR(40) 

SMALLINT 

VARCHAR(30) 

SMALLINT 

VARCHAR(15) 

SMALLINT 

VARCHAR(40) 

SMALLINT 

INTEGER 





PK 


iphoneid 


SERIAL 


FK1 


optphonetype 

phonenumber 

pvtphonenumber 

iphcneuserid 


SMALLINT 

VARCHAR(30) 

SMALLINT 

INTEGER 





PK 


lemaflid 


SERIAL 


FK1 


optemailtype 

emailaddress 

pvtemailaddress 

iemailuserid 


SMALLINT 

VARCHAR(IOO) 

SMALLINT 

INTEGER 



PATENT APPUCATION 



DECLARATION AND POWER OF ATTORNEY 
FOR PATENT APPUCATION 



ATTORNEY DOCKET NO. 10992822-1 



As a below named inventor, I hereby declare that: 

My residence/post office address and citizenship are as stated below next to my name; 

I believe I am the original, first and sole inventor (if only one name is listed below) or an original, first and 
joint inventor (if plural names are listed below) of the subject matter which is claimed and for which a 
patent is sought on the invention entitled: 

E-SERVICE TO MANAGE CONTACT INFORMATION WITH PRIVACY LEVELS 

the specification of which is attached hereto unless the following box is checked: 



( ) was filed on 
Number 



as US Application Serial No. or POT International Application 

and was amended on (if applicable). 



I hereby state that I have reviewed and understood the contents of the above-identified specification, 
including the claims, as amended by any amendment(s) referred to above. I acknowledge the duty to 
disclose all information which is material to patentability as defined in 37 CFR 1.56. 

Foreign Application(s) and/ or Claim of Foreign Priority 

1 hereby claim foreign priority benefits under Title 35, United States Code Section 119 of any foreign application(s) for patent or 
inventcr(s) certificate listed below and have also identified below any foreign application for patent or inventor(s) certificate having 
a filing date before that of the application on which priority is claimed: 



COUNTRY 


APPLICATION NUMBER 


DATE FILED 


PRIORITY CLAIMED UNDER 35 U.SC. 119 








YES NO. 








YES. NO 



Provisional Application 

I hereby claim the benefit under Title 35, United States Code Section 119(e) of any United States provisional application(s) listed 
below : 



APPLICATION SEFaAL NUMBER 



FILING DATE 



U. S. Priority Claim 

I hereby claim the benefit under Title 35, United States Code, Section 120 of any United States application{s) listed below and, 
insofar as the subject matter of each of the claims of this application is not disclosed in the prior United States application in the 
manner provided by the first paragraph of Title 35, United States Code Section 112, I acknowledge the duty to disclose material 
information as defined in Title 37, Code of Federal Regulations, Section 1.56(a) which occurred between the filing date of the prior 
application and the national or PCT international filing date of this application: 



APPLICATION SERIAL NUMBER 


RL(NG DATE 


STATUS (patented/pending/abandoned) 





















POWER OF ATTORNEY: 

As a named inventor, I hereby appoint the following attorney (s) and/or agent{s) to prosecute this application and transact all 
business in the Patent and Trademark Office connected therewith: 



Customer Number 022879 



Race Customer 
Number Bar Code 
Label here 



Send Correspondence to: 


Direct Telephone Calls To: 


HBWLETT-PACKARD COMPANY 




Intellectual Property Administration 


Paul E Lewkowicz 


P.O. Box 272400 




Fort Collins, Colorado 80528-9599 


(408) 453-9200 



I hereby declare that all statements made herein of my own knowledge are true and that ail statements 
made on information and belief are believed to be true; and further that these statements were made 
with the knowledge that willful false statements and the like so made are punishable by fine or 
imprisonment, or both, under Section 1001 of Title 18 of the United States Code and that such willful 
false statements may jeopardize the validity of the application or any patent issued thereon. 



Full Name of Inventor: James G. Douvikas 



Citizenship: USA 



Danville, California 

officj4 Addres^^ 79^ Tunbriji^e Road, Danville, OA 94526 




nofs Signature 

Rev 11/99 (Deeper) 




Date 

(Use Page Two For Additional Inventor(s) Signature(s)) 
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DECLARATION AND POWER OF ATTORNEY 
FOR PATENT APPUCATION (continued) 



ATTORNEY DOCKET NO. 10992822-1 



Full Name of # 2 joint inventor: Terry R. Sheehy 

Residence: 
Post Office Address: 



Citizenship: Britain 



Mountain View, California 

435 Nicholas Drive, Mountain View, CA 94043 



Date 



Full Name of # 3 joint inventor: Christopher W. T. McKay 

Residence: Paddington, NSW 2021, Australia 

Post Office Address: 



Citizenship: New Zealand 



43 Gordon Street, Paddington, NSW 2021, Australia 



inventors signature 



Date 



Full Name of # 4 joint inventor: 

Residence: 

Post Office Address: 



inventors t>ignature 



Citizenship: 



Date 



Full Name of # 5 joint inventor: 

Residence: 

Post Office Address: 



Inventor's signature 



Citizenship: 



Date 



Full Name of # 6 joint inventor: 

Residence: 

Post Office Address: 



I nventor" s signature 



Citizenship: 



Date 



Full Name of # 7 joint inventor: 

Residence: 

Post Office Address: 



inventors signature 



Citizenship: 



Date 



Full Name of # 8 joint inventor 

Residence: 

Post Office Address: 



inventors signature 



Citizenship: 



Date 



Rev 11/99 (DecPwr) 



(Use Page Two For Additional Inventor(s) Signature{s)) 
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ECARDFILE 
A P I 



Package lifdey^ 



Other Packages 

• package .default 

• package ecardfile.appl 

• package erardfile.dbappl 

• package multiserwapplsen^et 

• package multiserwdbmgr 

• pack^e multiserwsessionmgr 

• package multisen\util 



package-defautt 

Class ludey^. 

• I .o ginSen^let 

• SearchSen'let 



Class Lc^inServiet 



Object 

I 

+ — GenericServlet 

■ 1 

+ HttpServlet 

+ ApplServlet: 

I 

+ LoginServlet 



public class LoginServiet 

extends ApplSeniet 

Used to override the getAppKcationlnterf ace method defined in ^plServlet. 
method pK)vides the link between the generic components of package 
multisenr-applservlet and the application specific functionality. 

CoftBpmePor 

^ LoginSenlet O 

» geL\pplicationInterface O 

Overrides the getApplicationlnterface method defined in class 

ApplServlet. 
»init(ServletConfig) 

Called when the senrlet fiist gets loaded 

CotfsPrucpors 

i^LoginSendet ^ 

public LoginServlet { ) 

M^P^ods 

• get^plicationlnterface 

public multiserv.applservlet .Applicationlnterface 

getApplicationlnterf ace ( ) 

Overrides the getApplicationlnterface method defined in class 
ApplServlet. litis method must return an instance of the application 
specific class T\^ch implements Applicationlnterface. 
Overrides: 

get Applic at io nl nte rf ace in class ApplSen^let 
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•init 



piiblic void init (ServletConf ig config) throws ServletException 
Galled when the servlet first gets loaded Do our application specific 
sen^let initialization here after calling initQ in AppBen^IeL 
Parameters: 

config - serv^let conf^;uiation information. 
Throws: SenrletException 

a problem occurred during the initialization of the servlet. 
Overrides: 

init in class ApplSen^let 
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Class SearchServfet 

Object 
i 

+ GenericServlet 

I 

+ HttpServlet 

I 

+ .HCoiServiet 



-SearchServlet 



public class SearchServiet 

extends ApplSen^let 

Used to override the getApplicationlnterface method defined in ApplSeivlet. This 
method provides the link between the generic components of package 
multiserv.applservlet and the application specific functionality. 

CoffsPriicPor lndev^ 

^SearchServlet Q 

• geL^plic ationi nte rfac e Q 

Overrides the getApplicationlnterface method defined in class 

ApplServlet. 
•init(ServletConfig) 

Galled when the servlet first gets loaded 

CofisPtHcPors 

SearchServlet 

public SearchServlet ( ) 

M^P^ods 

• getApplicationlnterface 

public multiserv. applservlet .Applicationlnterface 
getApplicationlnterface ( ) 

Overrides the getApplicationlnterface method defined in class 

ApplServlet. This method must return an instance of the application 

specific class which implements i^plicationlnterface. 

Overrides: 
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geL.-\pplicationIntei1ac'e in class ApplSen let 

•bit 

public void init (ServletConf ig config) throws ServletException 
Called when the servlet first gets loaded Do our application specific 
servlet initialization herc after calling initQ in ApplServlet. 
Parameters: 

conf^ - senrlet configuration information. 
Throws: ServletException 

a problem occurred durir^ the initialization of the servlet 
Overrides: 

init in class ApplSer\^let 
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package ecardfile.appl 

IfiPerUce /ff^/eK 

• ComnionConfe 

C/ass I/tdeK 

• CommonApplicationlnterfjce 

• EcardNotifier 

• Lo ginApplirationlnterface 

• Seardx^ppluMtionlnterf ace 



Interface ecardfile-appLCommonConfig 

public abstraa interface CommonConfig 

Defines the common constants used by the application 

> ADDLIST_TAG 

> ADDRESSID_TAG 

..\DDUSE RCONFIRM_TAG 

» .^DUSER_TAG 

> ALTFIRSTNAME_COL 

,ALTFIRSTNAME_TAG 

.ALTFIRSTNAME TOKEN 

.BANNERTOKEN 

>BUSINESSCOMMENT_TOKEN 

. BLTTONTAG 

•CANCELJCAG 

.GARDE XTRA 

. C4RDID TAG 

. CARDID TOKEN 

> CATEGORY_TOKEN 

. CHANGE 

. CH.ANGE DETAILS TAG 
. CHANGE \CHE RE AMIT AG 
. COMPANYNAME COL 
. CQMPAN YN.^ME ENC TOKE N 
. COMPANYNAMETAG 
. COMPANYNAME TOKE N 
.CONFIRM TAG 
.CONTACICOL 
.CREATEID TAG 
.DATE OFENTRYTAG 
. DATE OFENTRYTOKEN 
. DE LETE USE RCONFIRMTAG 
. DELETEUSER_TAG 
. DELETE TAG 
. DISPLAY 

. DISPLAWMTTAG 
. DISPL AYFMTTOKE N 
. DISPLAYLISTTAG 
. DISPLAYPAGETAG 
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. DOADDWHE RETAG 
.DOCHANGF DETAILS TAG 
.DOCHANGE WHERE TAG 
.DODOWNLOADCARD TAG 
. DODO^X^LOADPLIST TAG 
■ DODO^X^'LOADSTNGLE TAG 
■ DOSE ARCH TAG 
. DOLTDATE PLIST TAG 
.DOW'NLOADFMT TAG 
, DO\C^'LOADID TAG 
,DO^-NLOADSINGLE TAG 
. nOWXl O.AD TAG 
■ ECARDID TAG 
-FCARDID TOKEN 
■ FDTTPRIVACY TAG 
■ EMATT ALTH COL 
■ EMAILAUTH TAG 
.E M AI L AUTH_TOKEN 
. EM.AILIDTAG 
. E PASSTORDCONF TAG 
. E PASSWORD TAG 
.EXPIRmATE COL 
■ FIND PASSWORD TAG 
■ FTRSTNAME COL 
■ FIRSTN.AME E NC TORE N 
■FTRSTN.AME TAG 
■ FI RSTN.AM ETOKE N 
■ FMT TAG 
■ FLTLNAMETOKEN 
■ HTML 

■ ID REWTUTE TOKEN 
■ ID TOKEN 
■JOBTTTLETOKEN 
■ I.ASTNAME COL 
■LASTNAMF ENC TOKEN 
■ T ASTNAME TAG 
■ L ASTN.AME _T ORE N 
. 1 CPRI VACATRE FIX 
■ LISTITEMSTOKEN 
■ LOGINSERVLETTOKEN 
. MASK_COL 
■ MASKTOKEN 
■ MIDDLEN.AME COL 
■ MI DDLE NAME TAG 
■MIDDLENAME TOKEN 
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.MSG T TST TOKEN 

.NFWIJSER TAG 

. OKTAG 

■ONFTTME TAG 

■PAGE TAG 

■ PAGE TOKEN 

■PASSWORD COL 

■PASSWORD TOKEN 

■PDAPAGE TAG 

■PFRSONALT TSTID COL 

■ PFRSONALL TSTTTFMS TOKEN 

■PHONEID TAG 
■ PRTVAr\TREFIX 
■ PVTALTFIR STNAMF TOKEN 
■PVTBUSINF SSCOMME NTTOKEN 
■ PVTCOMP ANYNAME TOKEN 

.P\rrroNTAcr col 

■PVTFIRSTNAMF TOKEN 
■ PWJOBTITT F TOKEN 
■ P\a'LASTNA1VIF TOKEN 
■ PVTT TSTID COL 
■ P\n-LISTID_TOKEN 
■P\TMIDD TFKAMF TOKEN 
■ PVTSUFFIX TOKEN 
■ PVTTITLE TOKEN 
■PVTWEBPAGFTIRL TOKEN 
■ ROWID TAG 
■SF ARCHID TAG 
■ SFARCHLISTTTFMS TOKEN 

■ SFARCHNAME TAG 

■SE ARCH SFR\T FT TOKEN 

■SF ARCH TAG 

■ STTE ADDRF SS TOKEN 

■ SOT INDEX TAG 

■ ST JFFIX COL 

■ ST IFFTX TOKEN 

■ TEMPLATE 

■ TTTLE COL 

■ TITTETOKEN 

■ TIPDATE TAG 

■TISFRTNFOID TAG 

■ TJSFRSID COL 

■ T ISFRSTD TOKEN 

■ WF.BPAGFTTRT FNC TOKEN 

■ WF. BPAGE T IRI - TOKE N 
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.WHEREAMI 

.\mEREAMI_TAG 

. WML 

•monthNames 

Static array with the names of the months for formatting dates 

yariakUs 

•ADDLIST_TAG 

p\±»lic static final java. lang. String ADDLIST_TAG 
•ADDRESSID TAG 

public static final j ava . lang . String ADDRESSID_TAG 
•ADDUSERCONFIRMTAG 

piiblic static final j ava . lang . String 

ADDUSERCONFIRM_TAG 

•ADDUSER_TAG 

pxablic static final java. lang. String ADDUSER_TAG 
•ALTFIRSTNAME_COL 

public static final j ava . lang . String ALTFlRSTNAME_COL 
•ALTFIRSTNAMETAG 

public static. final j ava . lang . String ALTFIRSTNAME_TAG 
•ALTFIRSTNAMETOKEN 

public static final java . lang. String 

ALTFIRSTNAME_TOKEN 

•BANNER_TOKEN 

public static final java. lang. String BANNER_TOKEN 
•BUSINESSCOMMENT_TOKEN 

public static final j ava . lang . String 

BUSINESSCOMMENT_TOKEN 

•BUTTON_TAG 

public static final j ava . lang . String BUTTON_TAG 
•CANCEL_TAG 

public static final java. lang. String CANCEL_TAG 
•CARDEXTRA 
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piiblic static final "short CARDEXTRA 
•CARDID TAG 



public static final j ava . lang . String CARDID_TAG 
•CARDID TOKEN 

piiblic static final j ava. lang. String CARDID_TOKEN 
•CATEGORY_TOKEN 

public static final j ava . lang . String CATEGORY_TOKEN 
•CHANGE 



public static final short CHANGE . 
•CHANGEDETAILS_TAG 

pxablic static final j ava . lang . String 

CHANGEDETAILS_TAG 

•CHANGE WHERE AMI_TAG 

public static final j ava. lang. String 

CHANGEWHEREAMI_TAG 

•COMPANYNAMECOL 



p\ablic static final j ava. lang. String COMPANYNAME_COL 
•COMPANYNAME_ENC_TOKEN 

public static final j ava. lang. String 

COMPANYNAME_ENC_TOKEN 

•COMPANYNAME_TAG 

public static final j ava. lang. String COMPANYNAME_TAG 
•COMPANYNAMETOKEN 

piiblic static final j ava. lang. String 

COMPANYNAME_TOKEN 

•CONFIRMTAG 

p\iblic static final j ava. lang. String CONFIRM_TAG 
•CONTACT COL 

public static final j ava. lang. String CONTACT_COL 
•CREATEID_TAG 

public static final java. lang. String CREATEID_TAG 
•DATEOFENTRY TAG 
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public static final j ava . lang . String DATEOFENTRY_TAG 
•DATEOFENTRYTOKEN 

pxiblic static final java. lang. String 

DATEOFENTRY_TOKEN 

•DELETE USERCONHRM^TAG 

piiblic static final java. lang. String 

DELETEUSERCONFIRM_TAG 

•DELETEUSERTAG 

piiblic static final java. lang. String DELETEUSER_TAG 
•DELETE_TAG 

public static final java. lang. String DELETE_TAG 
•DISPLAY 

public static final short DISPLAY 
•DISPLAYFMT_TAG 

public static final java. lang. String DISPLAYFMT_TAG 
•DISPLAYFMT_TOKEN 

public static final j ava . lang . String DISPLAYFMT_TOKEN 
•DISPLAYLIST_TAG 

p-ublic static final j ava . lang . String DISPLAYLIST_TAG 
•DISPLAY_PAGE_TAG 

public static final java. lang. String DISPliAY_PAGE_TAG 
•DOADDWHERE_TAG 

public static final java. lang. String DOADDWHERE_TAG 
•DOCHANGEDETAILS_TAG 

public static final java. lang. String 
DOCHANGEDETAILS_TAG 

•DOCHANGEWHERE_TAG 

public static final j ava . lang . String 

DOCHANGEWHERE_TAG 

•DODOWNLOADCARD_TAG 
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public static final java. lang. String 
DODOWNLOADCARD_TAG 
•DODOWNLOADPLIST TAG 



public static final java. lang. String 

DODOWNLOADPLIST_TAG 

•DODOWNLOADSINGLE_TAG 

pxiblic static final java. lang. String 
DODOWNLOADS INGLE_TAG 
•DOSEARCH_TAG 

public static final java. lang. String DOSEARCH_TAG 
•DOUPDATEPLIST_TAG 

public static final java. lang. String 

DOUPDATEPLIST_TAG 

•DOWLOADFMT_TAG 

public static final java. lang. String DOWNLOADFMT_TAG 
•DOWNLOADID_TAG 

piiblic static final java. lang. String DOWNLOADID_TAG 
•DOWNLOADSINGLE_TAG 

public static final java. lang. String 
DOWNLOADS INGLE_TAG 
•DOWNLOAD TAG 

piiblic static final java. lang. String DOWNLOAD_TAG 
•ECARDID_TAG 

public static final java. lang. String ECARDID_TAG 
•ECARDID_TOKEN 

public static final java. lang. String ECARDID_TOKEN 
•EDITPRIVACY_TAG 

public static final java. lang. String EDITPRIVACY_TAG 
•EMAILAUTH_COL 

piiblic static final java. lang. String EMAILAUTH_COL 
•EMAILAUTH_TAG 

public static final java. lang. St ring EMAIIiAUTH_TAG 



18 



•EMAILAUTH_TOKEN 

public static final j ava . lang . String EMAILAUTH_TOKSN 
•EMAILID_TAG 

public static final j ava. lang. String EMAILID_TAG 
•EPASSWORDCONFTAG 

public static final j ava . lang . String 

EPASSWORDCONF_TAG 

•EPASSWORD TAG 

public static final j ava. lang. String EPASSWORD_TAG 
•EXPIRYDATE_COL 

public static final j ava . lang . String EXPIRYDATE_COL 
•FIND_PASSWORD_TAG 

public static final j ava . lang . String 

FIND_PASSWORD_TAG 

•FIRSTNAMECOL 

piiblic static final j ava . lang . String FIRSTNAME_COL 
•FIRSTNAME ENC TOKEN 

p\iblic static, final j ava . lang . String 

FIRSTNAME_ENC_TOKEN 

•FIRSTNAME_TAG 

public static final j ava. lang. String FIRSTNAME_TAG 
•FIRSTNAME_TOKEN 

public static final j ava . lang . String FIRSTNAME_TOKEN 
•FMT TAG 

public static final j ava . lang . String FMT_TAG 
• FULLNAMETOKEN 

public static final j ava. lang. String FULLNAME_TOKEN 
•HTML 



public static final j ava. lang. String HTML 
•ID_REWITE_TOKEN 

public static final j ava. lang. String ID_REVfRITE_TOKEN 
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•ID_TOKEN 



public static final j ava . lang . String ID_TOKEN 
•JOBTITLE_TOKEN 

public static final j ava . lang . String JOBTITLE_TOKEN 
•LASTNAME_COL 

public static final j ava. lang. String LASTNAME_COL 
•LASTNAME_ENC_TOKEN 

pioblic static final j ava. lang. String 

LASTNAME_ENC_TOKEN 

•LASTNAME_TAG 

public static final j ava. lang. String LASTNAME_TAG 
•LASTNAME_TOKEN 

public static final j ava . lang . String liASTNAME_TOKEN 
•LC_PRIVACYPREFIX 

pviblic static final j ava. lang. String LC_PRIVACYPREFIX 
•LISTlTEMS_TOKEN 

public static final j ava. lang. String LISTITEMS_TOKEN 
•LOGIN_SERVLET_TOKEN 

piiblic static final j ava . lang . String 

LOGIN_SERVLET_TOKEN 

•MASK_(X)L 

piiblic static final j ava . lang . String MASK_COL 
•MASK_TOKEN 

public static final j ava . lang . String MASK_TOKEN 
•MIDDLENAMECOL 

public static final j ava. lang. String MIDDLENAME_COL 
•MIDDLENAME_TAG 

public static final j ava. lang. String MIDDLENAME_TAG 
•MIDDLENAME_TOKEN 

public static final j ava. lang. String MIDDLENAME_TOKEN 
•MSG_LIST_TOKEN 
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pioblic static final j ava . lang . String MSG_LIST_TOKEN 
•NEmJSER_TAG 

pviblic static final j ava. lang. String NEWUSER_TAG 
•OKTAG 

public static final j ava. lang. String OK_TAG 
•ONETlME_TAG 

piiblic static final j ava. lang. String ONETIME_TAG 
•PAGE_TAG 

public static final j ava . lang . String PAGE_TAG 
•PAGE_TOKEN 

public static final j ava. lang. String PAGE_TOKEN 
•PASSWORD_COL 

public static final j ava . lang . String PASSWORD_COL 
•PASSWORD_TOKEN 

piiblic static final j ava . lang . String PASSWORD_TOKEN 
•PDAPAGETAG 

pviblic static final j ava. lang. String PDAPAGE_TAG 
•PERSONALLISTIDCOL 

public static final j ava . lang . String 

PERSONALLISTID_COL 

•PERSONALLISTITEMS_TOKEN 

public static final j ava. lang. String 

PERSONALLISTITEMS_TOKEN 

•PHONEID_TAG 

piablic static final j ava. lang. String PHONEID_TAG 
•PRIVACYPREFIX 



pviblic static final j ava , lang . String PRIVACYPREFIX 
•PVTALTFIRSTNAMETOKEN 

public static final j ava. lang. String 

PVTALTFIRSTNAME_TOKEN 

•PVTBUSINESSCOMMENTTOKEN 
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public static final java. lang. String 
PVTBUS INESS COMMENT__TOKEN 
•PVTCOMPANYNAME_TOKEN 

pxiblic static final java, lang. String 

PVTCOMPANYNAME_TOKEN 

•PVTCONTACrCOL 

public static final java. lang. String PVTCONTACT_COL 
•PVTFIRSTNAME_TOKEN 

pxiblic static final java. lang. String 

PVTFIRSTNAME_TOKEN 

•PVTJOBTITLETOKEN 

public static final java. lang. String 

PVTJOBTITLE_TOKEN 

•PVTLASTNAME^TOKEN 

public static final java. lang. String 

PVTLASTNAME^TOKEN 

•PVTLISTID^COL 

public static final java. lang, String PVTLISTID_COL 
•PVTLISTID_TOKEN 

piiblic static final java. lang. String PVTLISTID^TOKEN 
•PVTMIDDLENAME TOKEN 

public static final java. lang. String 
PVTMIDDLENAME_TOKEN 

•PVTSUFFIX_TOKEN 

public static final java . lang . String PVTSUFFIX_TOKEN 
•PVTTITLETOKEN 

public static final java. lang. String PVTTITLE_TOKEN 
•PVTWEBPAGEURL_TOKEN 

pioblic static final java. lang. String 

PVTWEBPAGEURL^TOKEN 

•ROWID_^TAG 

public static final java . lang. String ROWID_TAG 
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•SEARCHID_TAG 

public static final java. lang. String ■SEARCHID_TAG 
•SEARCHLISTITEMS_TOKEN 

public static final java. lang. String 

SEARCHLISTITEMS_TOKEN 

•SEARCHNAME_TAG 

piiblic static final java. lang. String SEARCHNAME_TAG 
•SEARCH SERVLET TOKEN 

public static final java. lang. String 

SEARCH_SERVLET_TOKEN 

•SEARCHTAG 

public static final java. lang. String SEARCH_TAG 
•SITE_ADDRESS_TOKEN 

public static final java. lang. String 

SITE_ADDRESS_TOKEN 

•SOUNDEX_TAG 

p-ublic static final java. lang. String SOUNDEX_TAG 
•SUFFIX_COL 

public static final java. lang. String SUFFIX_COL 
•SUFFIX TOKEN 

piiblic static final java. lang. String SUFFIX_TOKEN 
•TEMPLATE 

pxiblic static final java. lang. String TEMPLATE 
•TITLECOL 

pxiblic static final java. lang. String TITLE_COL 
•TITLE_TOKEN 

public static final java. lang. String TITLE_TOKEN 
•UPDATE_TAG 

public static final java. lang. String UPDATE_TAG 
•USERINFOIDTAG 

piiblic static final java. lang. String USERINFOID_TAG 
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•USERSIDCOL 



public static final java. lang. String USERSID_COL 
•USERSID_TOKEN 

pxiblic static final j a va. lang. String USERSID_TOKEN 
•WEBPAGEURL_ENC_TOKEN 

public static final java. lang. String 

WEBPAGEURL_ENC_TOKEN 

•WEBPAGEURL_TOKEN 

public static final java. lang. String WEBPAGEURL__TOKEN 
•WHERE AMI 

public static final short WHEREAMI 
•WHERE AMI TAG 

public static final java. lang. String WHEREAMI_TAG 
•WML 

public static final java. lang. String WML 
•monthNames 

piiblic static final java. lang. String [] monthNames 
Static array with the names of the months for formatting dates 
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Class ecardfile-apphCommoriAppiicationlriteiface 



Object 



+ RemoteOb j ec t 



+ RemoteServer 



+ UnicastRemoteOb j ect 



+ Ap plicationlnterf ace 



+ 



ecardf ile.appl .CommonApplicationlnterface 

public abstract class Q)mmonApplicationInterface 

extends Ap plication! me rface 
implements SessionTags . ComrtionConfig 
Version: 

$Id: GommonAppKcationInterface.java,v 1.44 1999/12/03 02:05:45 peter 
Exp $ 
See Also: 

ApplicationInterface > SearcLA^pplicationlntertace , 
LoginApplicauonlnterface . RequesiHandler . LoginSeiTlet , SearchSen'let 



•accessDenied (String, FitpServletRequest, I-fttpServletResponse) 

Galled when a neceived nsquest does not contain a valid session id 
> addBannerToken (Hashtable) 

Add the banner text to the token table 
» c he c kAc cess (HttpServletRequest) 

Implementation of ApplicationlnterfaceircheckAccessQ. 
» chcckPrivacyAccess (DatabaseConnection2y long, long, Hashtable) 
# db_e mc)r (PfapServletRequest, litpServletResponse) 

A database error has occurred 




•defaultPdaPage 
p verboseErrors 




^cardfile.appLConimonApp licationlnterfaceO 
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»db_e rror (tfapServletRequest HtpServletResponse, String) 
A cktabase error has occurred 

•desfioyO 

Brush teeth before going to bed 

»doc_ac c es s_e mor (FfapServletRequest. PfepServletResponse) 

A document access error has occurred 
•getCookie (PfapSenrletRequest) 

Extract and return our cookie contents from the original HTTP request. 
♦ gctCookieTag O 
#getFullPath (String) 

Given an HTML document name determine if a full padi was specified. 
•getOpemtion (HctpServletRequest) 

Determine the type of operation to be invoked by the request. 
p getPassword (HttpSenrletRequest) 

Get a string representing the user s password 
»getSer\^etImgBtnParameter (FfapServletRequest) 
#getSessionId (HtpServletRequest) 

Extract and return the session id from the original HTTP request. 
• getUserld (PitpServletRequest) 

Get a string representing the user identification 
>hidde nFie Id (String. String) 

Return a string of HTML specifying a hidden field. 
•init(AppIServlet, String, String) 

Used to initialize the application specific class which implements this 

interface. 

» io e nx>r (FfapSeryletRequest. HctpSer^letResponse) 

An io exception has occurred 
• is Logged! n (Strii^, Session) 

Called to check if a user is logged in 
»nfe_e mor (HttpServletRequesty HtpServletResponse) 

A Nuni)erFormatException has occimred 
»nfe_e rror (FfapServletRequest, titpSen^letResponse, String) 

A NumberFormatExceprion has occurred 
»ns e _ e rror (PfopServletRequesL HttpServletResponse) 

A non-serializable exception has occurred 
#oper:ationRequire5Login (String) 

Called to check if a specified operation requires user login. 
»ne_e mor(PfapSeryletRequest, HtpServletResponse) 

A Remote Exception has occurred 
> s ae e rror (HttpServletRequest, HtpServletResponse) 

A Session Access Exception has occurred 
• s e ndPoc ume nt (String, HtpServletResponse) 

Send an HTML document to the liser replacing the predefined character 

sequences with their associated values. 
•sendEnor(String, String, String, HtpServletResponse) 



26 



»sendJError(Hashtable, Strii^, String, String, HttpServletResponse) 
9S e ndE m)r (Hashtable. String, Strii^, FitpServletResponse) 
• sendE mor (HttpServletReque$u String, String, I-fetpServleiResponse) 

General error handling routine. 
• $endLoginScneen (I-fctpServletReqiiest HttpServletResponse, String) 
• s c ndL oginSc t^e n (FfetpServletRequest. HttpServletResponse, String, Hashtable) 
•sendMessage (String, String, Hashtable, String, HttpServletResponse) 
•sendMessage (String, Strir^, HttpServletResponse) 
•sendMessage (String, Hashtable, String, PfapServletResponse) 
» sendParseDocument (Hashtable. Strii^, String, HttpServletResponse) 
• s e ndPars e Doc umc nt (Hashtable, String, HttpServletResponse) 

Send an HTML document to the user replacing the predefined character 

sequences with their associated values. 
• sendParseTextFile (String. String, Hashtable, String, String, 
HttpServletResponse) 

•sendParg eTextFile (Strings Hashtable, String, String, HttpSen^letResponse) 
• $ e nd Pa rs eTextPile (Iiashtable> String, String, HttpServletResponse) 

Send a text file to the user replacing the predefined charaaer sequences 

with their associated values. 
• sendSean rhScteen (tfapServletRequest, PfapServletResponse) 
>s e ndSe a re hSc te e n (HttpServletRequest. PfapServletResponse, String) 
» sendSear:hScree n (HttpServletRequest. HtpServletResponse, String, Hashtable) 
» s e s s ionFa ilure (String. HttpServletRequest) 

Implementation of ApplicarionInterface:sessionFailure Notify the 

application that an attempt to access a sesssion using sessionld failed 
» unknowTiOpe ration (HttpServletRequest, HttpServletResponse) 

An unknown operation has been requested 
»validatcSe$sion (String, Session, HttpServletRequest) 

Validate the passed session Hiis method can also be \ised to implement 

any security checks or other checks such as if undesirables are accessing 

the site - such as SPAMMERS 
» \'e rbos e E rm r (String) _ 

Method, which displays verbose error, messages to user if debug is turned 

on 




•defaultPdaPage 



public static final java. lang. String def aultPdaPage 

•veiboseEirois 



protected boolean verboseErrors 




Common^plicationlnterface 
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public CommonApplicationlnterf ace ( ) throws RemoteException 
•accessDenied 

pioblic void accessDenied (String operation, 

HttpServletRequest reg, 
HttpServletResponse resp) 
Called when a received request does not contain a valid session id The 
application should return an error/ wamir^ document to the user. If the 
error occurred during a normal operation (i.e. other than Logging in or 
Logging out) it was more than likely due to the session having expired. In 
this case just bring up the login screen. 
Paiametsers: 

operation - The operation which was being attempted 
req - The original HTTP request, 
resp - The HTTP response 
Overrides: 

accessDenied in class Ap plicationlnterface 
•addBannerToken 

protected void addBannerToken (Hasht able tokens) 

Add the banner text to the token table 

Parameters: 

tokens - the token table 
•checkAccess 

public boolean checkAccess (HttpServletRequest req) 

Implementation of Applicationlnterface-checkAccessQ. Check the HTTP 
request data and decide if zcctss should be allowed. We check to see if the 
IP Address is locked out. 
Parameters: 

req - The original HTTP request data. 
Returns: 

An indication if access is to be granted 
Overrides: 

checL^ccess in class Ap plicationlnterface 
•checkPrivacyAccess 

public short checkPrivacyAccess ( Data base Connection2 jdbc, 

long userld, 
long cardid, 
Hashtable cardRow) 

•dbertor 

public void db_error (HttpServletRequest req, 

HttpServletResponse resp) 
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A database error has occurred 
Overrides: 

db_error in class Applicationlmertace 
•dbenor 

public void db_error (HttpServletReguest req, 

HttpServletResponse resp. 

String msg) 
A database error has occurred 
Ovenides: 

db^error in class Applicationlnrertace 
•destroy 

protected void destroy 0 

Brush teeth before going to bed. 
Ovenides: 

destro}^ in class Applicationlnterface 
•doc_access_enx)r 

public void doc_access_error (HttpServletReguest reg, 

HttpServletResponse resp) 
A document access error has occurred 
Ovemdes: 

doc_access_error in class AppHcationlmerface 
•getCookie 

public j ava . lang . String getCookie (HttpServletReguest reg) 

Extract and return our cookie contents from the ordinal HTTP request* 
The cookie used by this application holds the session id 
Parameters: 

req - the original HTTP request. 
Retxims: 

the session id associated with the request. If no session id is found rctums 
null 

•getCookieTag 

public java.lang. String getCookieTag ( ) 
•getFullPath 

protected java.lang. String getFullPath (String document) 

Given an HTML document name determine if a full path was specified If 
not tackgetProperty("ecardfile.htmLbase") on to the front of the 
document 
Parameters: 

docximent - the filename of the HTML document to be sent 
Returns: 

full URL of document 
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•getOpeiation 

public java.lang. String getOperation (HttpServletReguest req) 

Determine the type of operation to be invoked by the request. Note that 

session creation and session destmction requests arc indicated by the 

operation strings defined by RequestHandler.CREATE and 

RequestP^dlerDESTROY respectively. 

Parameters: 

req - The HTTP request. 

Returns: 

A string describing the operation to carry ouL 
Overrides: 

getOperation in class Applicationlnterface 
•getPassword 

public java.lang. String getPassword (HttpServletRequest req) 
Get a string representing the user's password 
Parameters: 

req - The original HTTP request data. 
Returns: 

A string containing the password or null if the password tag isn't found in 

the HTTP request. 

Overrides: 

getPass^'ord in class Ap plicationlnterface 
• getSerdetlnigBtriiParameter 

public java.lang. String 

getServletlmgBtnParameter {HttpServletRequest req) throws 
SeirvletException, lOException 

•getSessionId 

public java.lang. String getSessionId (HttpServletRequest req) 
throws ServletException, lOException 

Extract and return the session id from the or^al HTTP request* 

Parameters: 

req - the original HTTP request. 
Returns: 

the session id associated with the request. If no session id is found returns 
null. 

Throws: ServletException 
Throws: lOException 
Overrides: 

getSessionId in class Applicationlnterface 
•getUseiid 

public java.lang. St ring getUserld (HttpServletRequest req) 
Get a string representing the user identification 
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Parameters: 

neq - The original HTTP request data. 
Returns: 

A string containing the user id or null if the user id tag isn't found in the 

HTTP request 

Overrides: 

getUserld in class Applicationlnterface 
•hiddenField 

protected java.lang. String hiddenField (String name. 

String value) 
Return a string of HTML specifying a hidden field 
Parameters: 

name - NAME of the hidden field 
value - VALUE of the hidden field 
Returns: 

HTML strii:^ as described above. 

•init 

public void init ( ApplServlet servlet. 
String managerName , 

String rmiHost) throws ServletException, 

lOException 

Used to initialize the application specific class, which implements this 
interface. The servlet configuration is passed in so that the seivlet 
environment is available to the application code* 
Parameters: 

applServlet - 'The Servlet instance which owns this Applicationlnterface 
instance. 

Throws: ServletException 
Overrides: 

init in class Applicationlntertace 
•io^erxor 

public void io_error (HttpServletRequest req, 

HttpServletResponse resp) 
An io exception has occurred 
Overrides: 

io_erTor in class Applicationlntertace 
•isLoggedIn 

protected boolean isLoggedIn (String sessionid, 

Session session) throws 

SessicnAcce s sSxcept ion , lOException 

Called to check if a user is logged in 
Parameters: 

sessionid - The Id of the current session 
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session - The current session 
Returns: 

Tme if the user is cmrently logged in 
•nfeertor 

public void nf e_error {HttpServletReguest reg, 

HttpServletResponse resp) 
ANumberFormatException has occurred 
Overrides: 

nie_error in class Applicationlnterface 
•nfeerror 

piiblic void nfe_error {HttpServletRequest req, 

HttpServletResponse resp, 
String msg) 
ANumberFormatException has occurred 
Overrides: 

nfe_error in class Applicationlnterface 
•nseenor 

public void nse_error {HttpServletRequest req, 

HttpServletResponse resp) 
A non-serializable exception has occurred 
Overrides: 

nse_error in class Applic atio ni nt e rt ac e 
• opeiationRequirc sLogin 

protected boolean operationRequiresLogin( String operation) 
Called to check if a specified operation requires user login. 
Parameters: 

operation - The operation which was being attempted. 
Returns: 

True if the operation requires login, false otherwise 
•rcenor 

public void re_error {HttpServletRequest req, 

HttpServletResponse resp) 
A Remote Exception has occurred 
Overrides: 

re^error in class ApplicationlnteTiace 
•sae_enDr 

public void sae_error (HttpServletRequest req, 

HttpServletResponse resp) 
A Session Access Exception has occurred 
Overrides: 
. sae^error in class Applicationlnterface 
•sendDocimient 
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piiblic void sendDocument (String document, 

HttpSeirvletResponse resp) 
Send an HTML document to the user replacing the predefined character 
sequences with their associated values. 
Parameters: 

document - the file name of the HTML document to be sent. All 
documents are accessed relative to our ecardfileJitml.base property 
resp - provides methods to respond to the ordinal HTTP request. 
•sendEnor 

public void sendError (String format, 

String msgl, 
String msg2, 

HttpServletResponse resp) 

•sendEnor 

public void sendError (Hashtable tokens. 

String format, 
String msgl. 
String msg2, 

HttpServletResponse resp) 

•sendEnor 

public void sendError {Hashtable tokens. 

String msgl, 
String msg2, 

HttpServletResponse resp) 

•sendEnor 

public void sendError (HttpServletReguest reg. 

String msgl, 
String msg2, 

HttpServletResponse resp) 
General error handling routine. 
Overrides: 

sendError in class Appiicati'onlnterf ace 
•sendLoginScreen 

protected void sendLoginScreen (HttpServletReguest req, ^ 

HttpServletResponse resp. 
String format) throws lOException 

• sendLoginScreen 

protected void sendLoginScreen ( HttpServletReguest req, 

HttpServletResponse resp, 
String format, 

Hashtable initTokens) throws 

lOException 
•sendMessage 
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public void sendMessage (String pdaPage, 

String MessageFile, 
Hashtable tokens, 
String format, 
HttpSexvletResponse resp) 

•sendMessage 

public void sendMessage {String MessageFile, 

String format, 
HttpServletResponse resp) 

•sendMessage 

public void sendMessage {String MessageFile, 

Hashtable tokens, 
String format, 
HttpServletResponse resp) 

•sendPaiseDocument 

public void sendParseDocument (Hashtable tokenTable, 

String document. 
String format, 
HttpServletResponse resp) 

•sendParseDocument 

public void sendParseDocument {Hashtable tokenTable, 

String document, 
HttpServletResponse resp) 

Send an HTML document to the user replacing the predefined character 

sequences with their associated values. 

Parameters: 

tokenTable - the tokens and values to be replaced in the document 
document - the file name of the HTML document to be sent. All 
documents are accessed relative to our ecaidfile.html.base property 
session. 

resp - provides methods to respond to the original HTTP request 
•sendParseTextFile 

public void sendParseText File (String contentXype, 

String fileName, 
Hashtable tokenTable, 
String document, 
String format, 
HttpServletResponse resp) 

• sendParseTextFile 

public void sendParseTextFile (String contentType, 

Hashtable tokenTable, 
String document, 
String format, 
HttpServletResponse resp) 



34 



• sendParseTextFile 



public void sendParseTextFile (Hashtable tokenTable, 

String document, 
String format, 
HttpServletResponse resp) 

Send a text file to the user replacing the predefined character sequences 

with their associated values. 

Parameters: 

contentType - Hie content type of the text file 

tokenTable - the tokens and values to be replaced in the document 

document - the file name of the HTML document to be sent. All 

documents are accessed relative to our ecardfile.html.base property 

session. 

format - the type of file to send, html or wml 
resp - provides methods to respond to the original HTTP request 
•sendSearchiScreen 

protected void sendSearchScreen(HttpServletRequest req, 

HttpServletResponse resp) 

•sendSeaichScreen 

protected void sendSearchScreen{HttpServletRequest req, 

HttpServletResponse resp, 
String format) throws 

lOException 
•sendSearchScreen 

protected void sendSearchScreen(HttpServletRequest req, 

HttpServletResponse resp. 
String format, 

Hashtable initTokens) throws 

lOException 
•sessionFailurc 

p\iblic boolean sessionFailure (String sessionid, 

HttpServletRequest req) 
Implementation of ApplicationInterface:sessionFailure Notify the 
application that an attempt to access a session using sessionid failed Tliis 
could be due to a bogus sessionid or an expired session. We keep track of 
the failures per IP Address so that they can be checked in checkAccessO 
Parameters: 

req - The original HTTP request data. 

sessionid - The session id string for the current session. 

Returns: 

If tme a new session will be created 
Overrides: 

sessionFailure in class Application! nierf ace 
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• unkno wnOpeiation 

public void imknownOperat ion {HttpServlet Request req, 

HttpServletResponse rasp) 

An unknown operation has been requested 

Overrides: 

unkno^nOpe ration in class Applicationlnterface 
•validateSession 

public boolean validateSession (String sessionid. 

Session session, 
HttpServletRequest req) throws 

Exception 

VaKdate the passed session This method can also be used to implement 
any security checks or other checks such as if undesirables are accessing 
the site - such as SPAMMERS 
Parameters: 

session - The session to validate, 
req - The ordinal HTTP request data. 
Returns: 

An indication if the session is valid 
Overrides: 

validateSession in class Applicationlnterface 
•^^IboseEm)r 

protected j ava . lang . String verboseError (String msg) 

Method which displays verbose error messages to user if debug is turned 
on 
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Class ecardfileiappl.EcardNotifier 



Ob j ect 

i 

+ ecardf i le . app 1 . EcardNot i f ier 

public class EcaidNotifier 

extends Object 
implements Runnable 

CoffsPrnePor ItideK 

< ecandrile.appl.EcardNotifier (CommonApplicationIntetface, String, long. 
String) 

• interrupt p 
»mn0 
•startQ 
•stopO 

Co^sPrncpors 

^EcaidNotifier 

public EcardNotif ier (Com Tion.K ppli cat icnlnter face parent, 

String templateCache, 
long cardid. 
String eCardId) 

M^pkods 

•interrupt 

public void interrupt () ' 

•run 

public void run() 
•start 

public void start () 
•stx)p 

public void stopO 



37 



Class ecardfiie-appLLoginApplicationirtteiface 



Object 



+ Remot eOb j ect 



+ Remot eServer 



+ UnicastRemoteObject 



+ Ap plicationlnterf ace 



+ 



CommonApplicationlnterface 



+ 



ecardf ile .appl .LoginApplicationlnterf ace 

public class LoginApplicationlnterface 

extends CommorL^pplicationlnterface 
implements CQmmonG)nfig 

The class implements the application behavior for the LoginServlet. Many of the 
methods are hooks called by RequestHandler instances invoked by LoginServlet 
(i.e. ApplServlet), 
Version: 

$Id: LoginApplicationInterface.java,v 1.23 1999/11/24 02:24:41 peter Exp 



•accessDenied{String, HrtpServletRequest, HttpServletResponse) 

Called when a rcceived request does not contain a valid session id 

# a uthe ntic ate Us e r(String, String, HttpServletRequest) 

Authenticate the user using a user id and password combination. 

»e xe c ute Ope ratio n (String. String, Session, HttpServletRequest, 

HttpServletResponse) 

Called by RequestHandler to execute an application defined operation. 

»getCookieTag O 

. Return the application specific cookie tag 



$ 

See Also: 



RequestKmdlen LoginSen^let, CommQnConfig , Sessionlmpl 





^cardfite. appl.Lo ginApplicationlnterface Q 
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»init(ApplSeivlet. String, String) 

Used to initialize the appKcation specific class which implements this 

interface, 
»notiiy (SessionNotification) 

Receives (asynchronous???) notifications from XXX This overrides the 

corresponding method in Applicationlnterface which in turn implements 

the method 

» pos L\uthe ritic ate (String. Session, ffepServletRequest, HttpServletResponse) 

Post authentication functionality. 
» po s tPe s tro y (?6tpServletRequest, HttpServletResponse) 

Called by the RequestHandier immediately after the destruction of the 

session object, 

• pre De s troy (String, Session, HttpServletRequest, HttpServletResponse) 

Called by RequestHandier prior to the destmcrion of the session object. 

ConsPnicpors 

i^LoginApplicationlnte rface 

public LoginApplicationlnterf ace ( ) throws RemoteException 
•accessDenied 

public void accessDenied (String operation, 

HttpServletRequest reg, 
HttpServletResponse resp) 
Called when-a received request does not contain a valid session id The 
application should return an error/ warning document to the user. If the 
error occurred during a noraial operation (i.e, other than Loggir^ in or 
Lo^i^g out) it was more than lilily due to the session having expired. In 
this case just bring up the login screen. 
Parameters: 

operation - The operation which was being attempted 
req - The original HTIP request, 
resp - Hie HTTP response 
0\^nides: 

accessDenied in class Common^\pplicationlnterface 
• authenticateUs e r 

public multiserv. sessionmgr .GenericSession 
authenticateUser (String userName, 
String password, 

HttpServletRequest req) throws RemoteException, 
SessionAccessExcep tion, NotSerializableException, 
ServletException, lOException 



39 



Authenticate the user using a user id and password combination. 
Authentication is done against the database. This method can also be used 
to inclement any prc-session creation functionality. 
Parameters: 

\iserName - The user name string, 
password - The user's password string, 
req - The original HTTP request data. 
Retxims: 

A session object containii^ any initial session data. The returned object 
must be a sub-class of GenericSession. This will be used to initialize the 
session object in the session manager. If the authentication fails, null is 
returned 

Throws: RemoteException 

A problem occun^d while trying to create the session object in the 

SessionManager 

Overrides; 

authenticateUser in class Applicationlntert'ace 
See Also: 

UserAuth, Sessionlmpl 
•executseOperation 

public void executeOperat ion (String operation. 

String sessionid, 
Session session, 
HttpServletReguest req, 
HttpServletResponse resp) 

Called by RequestHandier to execute an application defined operation. 

Valid operations are: 

Ardiroscopy 

Performed on Peter's knee 

Operations can be specification of the OP_TAG as a hidden field or as 
part of a Query String in a GET request. Altematively, certab FORM 
buttons are defined to execute specific operations. 
Parameters: 

operation - Specifies the operation to perform. This should be one of the 

operation strings returned by getOperation, 

session - An interface to the current session object. 

req - The data from the original HTTP request. 

resp - Provides methods for responding to the request. 

Os^rrides: 

executeOpe ration in class Applicationlnterface 
•getCookieTag 

public java.lang.String getCookieTag { ) 
Return the application specific cookie tag 
Returns: 
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name of the application specific cookie 
Overrides: 

getCookielag in class CommorLApplicaiionlniertace 

•init 

piiblic void init ( ApplServlet servlet, 
String managerName , 

String rmiHost) throws ServletException, 

lOException 

Used to initialize the application specific class which implements this 
interface. The servlet configuration is passed in so that the servlet 
environment is available to the application code. 
Parameters: 

applServlet - The Servlet instance which owns this Applicationlnterf ace 
instance. 

Throws: ServletException 
Overrides: 

init in class Common.A.pplicationInrertace 
•notify 

public void notify ( Sess icr A-ct if icati cn nofn) 

Receives (asynchronous???) notifications from XXX This overrides the 
comespondir^ method in Applicationlnterface which in turn implements 
the method 
Parameters: 

nofn - An interface to the object carrying notification information. 
Overrides: 

notit)' in class Applicationlnteriace 
•postAuthenticate 

public void postAuthenticate (String sessionid, 

Ses sion session, 
HttpSexvletReguest req, 
HttpServletResponse resp) throws 

lOException, SessicnAccessExc e ptio n, ServletException, 

lOException 

Post authentication functionality. If the authentication had failed a screen 

displaying an appropraite message is displayed. 

O^nides: 

postAmhe nticate in class Applicationlnterface 
•postDesttoy 

public void postDestroy (HttpServletRequest req, 

HttpServletResponse resp) 
Called by the RequestHandler immediately after the destmction of the 
session object. The session is finished. Display the Login screen. 
Parameters: 

rcq - The data from the original HTTP request. 
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nesp - Provides methock for responding to the request. 
Overrides: 

postDestroy in class Applicationlnterface 
•preDesboy 

piiblic void preDestroy{ String sessionid, 

Session session, 
HttpServletRequest req, 
HttpServletResponse resp) 

Called by RequestHandler prior to the destruction of the session objecL 

Parameters: 

session - An interface to the associated session object, 
req - The data from the original HTTP request, 
resp - Provides methods for responding to the request. 
CK^nides: 

prePestro}^ in class Applicationlmeriace 
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Class ecardflie^ppl.SearchApplicationlnterface 



Object 
I 

+ RemoteObj ect 

+ RemoteServer 

I 

+ UnicastRemoteObject 

I 

+ Ar p licaticninte rface 

i 

+ 

ComrricnATDC licaticninterface 



ecardf ile . appl . SearchApplicationlnterf ace 

pubKc class SeaichApplicationlnterface 

extends CommorL\ppHcationInrerFace 
implements CommonConfig 

The class in^lements the application behavior for the SearchSen^let. Many of the 
methods are hooks called by RequestHandler instances invoked bySeanchSen^let 
(i.e. AppIServlet). 
Version; 

$Id: SearchApplicationInterface.java,v 1,59 1999/12/03 01:10:09 peter 
Exp$ 
See Also: 

RequestHandler ^ SearchServlet, CommonConfig ^ Sessionlmpl 



Yar/ak/e iHJey^, 

■ PRIVATE ACCESS 
. PUBL1C_ ACCESS 

CoMsPrMCpor Itidey^ 

^cardfile.appl.SeanrhApplicationlnterface Q 

MePlfod Iftdeyt, 

•accessDenied (String, HctpServletRequest, HfctpServletResponse) 

Called when a received request does not contain a valid session id. 

• a uthe ntica te Use r (Stringy String, HttpServletRequest) 

Authenticate the user using a user id and password combination, 

• c hec kPri\ a c }'Ac cess (short, Hashtable) 
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Checks all values in the card that is about to be displayed, if the privacy 

value for any value is higher than that granted by the card's owner the 

element is removed from the hashtable and the value is not displayed 
•destroyO 

Brush teeth before going to bed. 
»exc c ute Ope ration (String, Strii^, Session, PitpServletRequest, 
Htq)ServletResponse) 

Called by RequestHandler to execute an application defined operation. 
^getCookicTagQ 

Return the application specific cookie tag 
» getPri\ ac vAccess (DatabaseConnection2. long, long) 

Get the privacy mask for the logged in user and the card being displayed 
#ge tPri\ a c \'Ac cess (DatabaseConnection2y long, long, Hashtable) 
•init(ApplServlet. String, String) 

Used to initialize the application specific class, which implements this 

interface. 
•noti^'(SessionNotification) 

Receives (asynchronous???) notifications from XXX Tliis overrides the 

corresponding method in i^plicationlnterface which in turn implements 

the method 

> pos tA^uthe ntica te (String, Session, HttpServletRequest, HttpServletResponse) 

Post authentication functionality. 
»po s tPe s tmy (HttpServletRequest, litpServletResponse) 

Called by the RequestHandler immediately after the destruction of the 

session object. 

»preDestnc)y (String, Session, HttpServletRequest, HttpServletResponse) 

Called by RequestHandler prior to the destruction of the session object, 

•PRIVATEACCESS 

public static final short PRIVATE_ACCESS 

•PUBLIC_ACCESS 

public static final short PUBLIC_ACCESS 

CottBprnepors 

^ Searchi^plicationlnterface 

public SearchApplicationlnterf ace ( ) throws RemoteException 
•accessDenied 

public void accessDenied (String operation, 

HttpServletRequest req, 
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HttpServletResponse resp) 
Called when a received request does not contain a valid session id The 
application should return an error/ warning document to the user. If the 
error occured during a normal operation (i.e. other than Logging in or 
Lo^g out) it was more dian likely due to the session having expired In 
this case just bring up the login screen. 
Parameters: 

operation - The operation which was being attempted 
req - The original HTTP request, 
resp - The KTTP response 
Overrides: 

accessDenied in class CommorL\pplicationImertace 
• authenticateUser 

public multiserv.sessionmgr.GenericSession 
authenticateUser (String userName, 

String password, 

HttpServletRequest req) throws RemoteException, 
SessicnAccessExcept^ion, NotSerializableException, 
ServletException, lOException 

Authenticate the user using a user id and password combination. 

Authentication is done gainst the database. This method can also be used 

to implement any pre-session creation functionality. 

Parameters: 

userName - The user name string, 
password - The user s password string, 
req - The original HTTP request data. 
Returns: 

A session object containing any initial session data. The returned object 
must be a sub-class of GenericSession. This will be used to initialize the 
session object in the session manager. If the authenricatton fails, null is 
returned 

Throws: RemoteException 

A problem occurred xrym% to create the session object in the 

SessionManager 

Overrides: 

auihenticateUser m class Applicaiionlnterface 
See Also: 

UserAuth, Sessionlmpl 
•checkPrivacyAccess 

piiblic void CheckPrivacyAccess (short privacyLevel, 

Hashtable cardRow) 
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Checks all values in the card that is about to be displayed, if the privacy 
value for any value is higher than that granted by the card's owner the 
element is removed from the hashtable and the value is not displayed. 
Parameters: 

privacjLevel - Privacy value 

cardRow - Hashtable from which the elements arc removed 
•destroy 

protected void destroy {) 

Brush teeth before going to bed* 
Overrides: 

destro\- in class CommonApplicationlnteriace 
•execute Ope ration 

public void executeOperat ion (String operation. 

String sessionid, 
Session sessioiii 
HttpServletRec[uest req, 
HttpServletResponse resp) 

Galled byRequestHandler to execute an application defined operation. 

Valid operations arc: 

Arthroscopy 

Performed on Peter s knee 

Operations can be specification of the OP_TAG as a hidden field or as 
part of a Query String in a GET request. Altematively, certain FORM 
buttons arc defined to execute specific operations. 
Parameters: 

operation - Specifies the operation to perform. This should be one of the 

operation strings returned by getOperation, 

session - An interface to the current session object. 

req - The data from the original HTTP request. 

resp - Provides methods for responding to the request. 

Owrrides: 

executeOpemtion in class A pplicationlnterface 
•getCookieTag 

public java.lang, String getCookieTag ( ) 
Return the application specific cookie tag 
Returns: 

name of the application specific cookie 
Overrides: 

getCookieTng in class Co mmo n App lie at ioni nte rf ace 
•getPrivacyAccess 

public short getPrivacyAccess (D atabaseCQnnect ion2 jdbc, 

long loginid, 
long cardid) 
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Get the privacy imsk for the lo^ed in iiser and the card being displayed 
Parameters: 

jdbc - An open database conneaion 

loginld - user id of currently lo^ed in user (0 if not lo^ed in) 

cardid - user id of the card details being checked 

card - Card to add mask and privacy row id if required 

• getPrivacyAccess 

public void ge t Pr i vacyAc cessC Databa seC cnn ectionZ jdbc, 

long loginld, 
long cardid, 
Hashtable card) 

• init 

public void init (ApplSeorv let servlet, 
String manage rName , 

String rmiHost) throws ServletException, 

lOException 

Used to initialize the application specific class, which implements this 
interface. The servlet configuration is passed in so that the servlet 
environment is available to the application code. 
Parameters: 

applServlet - The Servlet instance which owns this Applicationlnterface 
instance. 

Throws: ServletException 
Overrides: 

init in class CommonApplk\nionIntei'face 
•notify 

public void notify (SessionKcti ficaticn nofn) 

Receives (asynchronous???) notifications from XXX This overrides the 
corresponding method in Applicationlnterface which in turn implements 
the method 
Parameters: 

nofn - An interface to the object carrying notification information. 
Overrides: 

notif)' in class Ap plicaiionlnterlace 
•postAuthenticate 

public void postAuthenticate (String sessionid, 

session session, 
HttpServletRequest req, 
HttpServletResponse resp) throws 
lOException, S ession^^ccessSxcepti on , ServletException 

Post authentication functionality. If the authentication had failed a screen 

displaying an appropriate mess^e is displayed 

Overrides: 

postAuthenticate in class ApplicationlmerfAce 
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•postDestioy 

public void postDestroy {HttpServletRequest req, 

HttpServletResponse resp) 
Called by the RequestHandler immediately after the destruction of the 
session objecL The session is finished. Display the Login screen. 
Paiameteis: 

req - The data from the original HTTP request. 

resp - Provides methods for responding to the request. 

Overrides: 

postDestroy in class Applicatio nlntertace 
•prcDestioy 

public void preDestroy (String sessionid, 

Session session, 
HttpServletRequest req, 
HttpServletResponse resp) 

Called by RequestHandler prior to the destruction of the session object. 

Parametets: 

session - An interface to the associated session object, 
req - The data from the original HTTP request, 
resp - Provides methods for responding to the request. 
Overrides: 

preDestro}' in class Applicationlnterface 
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package ecardfile-dbappl 

Class IndeK 

• Address 

• Banner 

• RnnnerQiche 

• D.imhaseCnnnection2 

• Email 

• In.irTiveAddress 

• TnActivePata hn^pConnection 

• TnactiveEmail 

• TnacTivePhone 

• TnactiveUser 

• LockedIP 

• Lookup 

• I ooku pCiche 

• PersonalList 

• Phone 

• PrivateList 

• User 

• Userlnfo - 

• IJserObiect 

• ^diereAnil 



Class ecardfi8e.dbapplJ^dress 



object 
I 

+ JdbcObject 

I 

+ UserObject 

+ ecardfile.dbappl. Address 

pubKc class Address 
extends UserObiect 



'^Address 

pioblic Address {Connection connect) throws Jdbc Exception 
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Class ecardfile.dbappl.Banner 



Object 

+ JdbcObject 

I 

+ ecardf ile . dbappl . Banner 

public class Banner 
•extends JdbcQbjea 

CoHsPrticPor If/iteK 

^catxlfile.dbappLBanner (Connection) 

CotfsPmcpors 

i^Banner 

public Banner (Connection connect) throws Jdbc Exception 
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Class ecardfile-dbappKBannerCache 



object 



+ Cache 



+ TableCache 



+ ecardf ile.dbappl .BannerCache 



pubKc class BanneiCache 
extends TableCache 
Cache of the Banner table 
See Also: 

TableQche 



^cardfile .dbappl.BannerCache Q 

Shouldn't use this constmaor 
^caitifile,dbappLBannerCache QdbcConnectionBix)ker2, long) 



» gc tj dbc Ob je c t (Connection) 

This method should be defined in the sub class. 
» getRandoirL\d Q 

Get a random Banner ad 
• populate 0 

The database table is populated by using a JDBC object created by 
getJdbcObject. 



S^BanneiCache 

public BannerCache ( ) 

Shouldn't use this constructor 
^BannerCache 

public BannerCache ( J d bc C onne c t i onB r oke r 2 connMgr, 



Parameters: 

conhMgr - - The JDBC Connection manager 
sees - - The cache is repopulated every sec? seconds 





long sees) throws lOException 
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•getJdbcObject 

protected multiserv.dbmgr . JdhcObject getJdbcObject (Connection 
connect) throws JdbcException 

Tliis method should be defined in the sub class. 

Overrides: 

get JdbcObieci in class TableCiche 
•getRandomAd 

public java.lang. String getRandotri?Vd ( ) 

Get a random Banner ad Basically it just returns an HTML String by using 

a random key into the banner table cache. 

Returns: 

String of HTML which can display an ad banner 
See Also: 
populate 
•populate 

pviblic void populate () 

The database table is populated by using a JDBC object created by 
getJdbcObject. We key a vector of keys locally. As records get 
added/deleted from the table the set of Ids will change. To retrieve 
random ads we randomly index into out local set of keys and use that key 
to pull an add from the cache. 
Overrides: 

populate in class TableQche 
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Class ecardlfile.dbappl.DatabaseConnection2 



Object 

+ JdbcConnect ion 

I 

+ ecardf ile .dbappl ,DatabaseConnection2 

pubKc class DatabaseConnection2 

extends JdbcConnection 

yariaMe Indey^ 

. DEBUG 

ConsPmePor Inde^ 

^cardfile,dbappLDatabaseConnection2 0 

Only to be used for JdbcConnectionBroker/JdbcG:>nnectionFactory 
^cardfile. dbappLDatabaseConnection2 (String, String, String) 

♦Address 0 

•BannerO 

•EniailO 

•initialize () 

♦LockedlP Q 

•LookupO 

♦PersonalList Q 

•PhoneO 

» PrivateList () 

•UserO 

•WhereAnilO 
•close () 

» ge tl ns ta nc e (String. String, String) 
•main(String[0 

•DEBUG 

public static boolean DEBUG 

ConsPmcPors 

^DatabaseConnection2 
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piiblic DatabaseCormection2 0 

Only to be used for JdbcCbnnccdonBroker/JdbcCbrmectionFactoiy 

^* DatabaseConnection2 

public DatabaseConnection2 (String URL, 

String usemame. 

String password) throws Jdbc Exc ep ticn 

•Address 

•public ecardfile.dbappl. Address Address () throws Jdcc E xcepncn 

•Banner 

public ecardfile.dbappl -Banner Banner () throws JdbcSxce pticn 
•Email 

public ecardfile.dbappl. Email Email () throws JdbcException 

•Initialize 

public void Initialize () throws Jd bcExcepticn 
Ovemdes: 

Initialize in class JdbcConnection 
•LockedIP 

public ecardfile.dbappl. LockedIP LockedIP () throws JdbcException 
•Lookup 

public ecardfile.dbappl. Lookup Lookup () throws Jd bcE xception 

•PersonalList 

public ecardfile.dbappl .PersonalList PersonalList { ) throws 

Jd bcExcepti on 

•Phone 

public ecardf ile.dbappl . Phone Phone {) throws JdbcException 

•PrivateList 

public ecardf ile.dbappl .PrivateList PrivateList { ) throws 

J d.b c Exce ptic n 

•User 

p\iblic ecardf ile.dbappl. User UserC) throws JdbcExceotion 

•mercAmI 

public ecardf ile.dbappl. WhereAmI WhereAmlO throws JdbcExce ption 

•close 

public void closed throws SQLException 
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Overrides: 

close in class JdbcConnection 
•getlnstance 

public multiserv.dbmgr. JdbcConnection getlnstance {String URL, 

String 

usemame , 

String 

password) throws JdbcException 
Overrides: 

getlnstance in class JdbcG:>nnection 

•main 

public static void main (String [] args) 
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Class ecardfiie.dbappl.Email 



Ob j ect 

+ JdbcCbjecc 

I 

+ UserGb ^ect 

I 

+ ecardfile.dbappl .Email 

public class Email 
extends UserObiect 

CoMsPmePor ItideK 

^canifile-dbappl.Email (Coiinection) 

Coffsprjfcpors 

^^Email 

public Email (Connection connect) throws J*ibcEx£e2tion 
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Class ecardfiie.dbappi.inactiveAddress 



Ob j ect 
I 

JdbcO bj ect 

+ UserObject 

I 

+ ecardf ile.dbappl . InactiveAddress 

public class InactiveAddress 

extends UserObject 



^InactiveAddress 

public InactiveAddress (Connection connect) throws JabcException 





^ c a rdfile .dba npL I nac ri vc Addres s (Connection) 
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Ciass 

ecardfile.dbappI.lnactlveDatabaseConnection 



Object 

I 

+ ecardf ile . dbappl . InactiveDatabaseConnection 

public class InactiveDatabaseConnection 

extends Object 

yanWe Itfdev, 

.DEBUG 

ConsPrMcPor Inde^ 

^cardfile.dbapplJnacriveDaLibaseConnection fConnection) 

MsP^Od /ffdSK 

^InactiveAddress O 
•InactiveEmailO 
• IiiactivePhone O 
» InactiveUser O 

•DEBUG 

public static boolean DEBUG 

Cottspruepors 

S*InactiveE>atabaseConriection 

public InactiveDatabaseConnection (Connection conn) 

M^Pffods 

• Inactive Address 

public ecardf ile. dbappl. InactiveAddress InactiveAddress () throws 

JdbcException 

•InactiveEmail 

public ecardf ile. dbappl. InactiveEmail InactiveEmailO throws 

Jd bcException 

•inactivePhone 
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public ecardfile.dbappl.InactivePhone InactivePhone ( ) throws 

J dbcEx ception 

•InactiveUser 

public ecardfile.dbappl. InactiveUser InactiveUser () throws 

JdbcExceiDtion 
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Class ecaixifile.dbappl.lnactiveEmail 



Ob j ect 

I 

+ JdDcCb^ ect 

r 

+ UserOb^ect 

+ ecardf ile.dbappl . InactiveEmail 

public class InactiveEmail 

extends UserObiect 



^InactiveEmail 

public InactiveEmail (Connection connect) throws Jdbc Exception 




^candfile.dbappl.InactiveEmaiK Connection) 
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Class ecardfile-dbappl-lnactivePhone 



Ob j ect 

I 

+ JdbcOb iect 

T 

+ UserObject 

I 

+ ecardf ile.dbappl . InactivePhone 

pubKc class InactivePhone 

extends UserObiect 

CoftsPrMePor ludey^ 

jtcz ndfile .dbapplJ nac rive Phone (Connection) 

ConsPmePors 

^InactivePhone 

public InactivePhone {Connection connect) throws JdbcException 
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Class ecardfile.dbappl.lnactiveUser 



Object 

+ JdbcObject 

+ ecardf ile .dbappl . InactiveUser 

pubKc class InactiveUser 
extends JdbcObiect 

CoffsPrf/ePor 

^caidfile.dbapplInactjveUser fConnection) 

MePhod IftdeK 

• Delete (InactivePatabaseConnection, long) 

•Get(Strir^ 

•Get(String, String) 

• Insert flnactivePaubaseConnection, StringD, Veaor, Veaor, Vector) 
• Update (InactivePatabaseConnection, String, Vector, Vector, Vector) 

CoH8prnePors 

InactiveUser 

public InactiveUser (Connection connect) throws Jd bcE x ception 

M^P^ods 

•Delete 

public int Delete ( inactivePatabase C onnection database, 
long userld) throws JdbcException 

•Get 

public java.util.Hashtable Get (String szECardId) throws 

Job cExcept ic n 

•Get 

public java.util.Hashtable Get (String szECardId, 

String szSessionId) throws 

JdbcException 

•Insert 

public long Insert (I nactivePatabaseConnection database. 

String [ ] userRow, 
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Vector addressRows, 
Vector phoneRows, 

Vector emailRows) throws JdbcExce ptiion 

•Update ^ 

piiblic long Update ( InactivePatabaseConnection database, 

String [] userRow, 
Vector addressRows, 
Vector phoneRows, 

Vector emailRows) throws JdbcExcepticn 
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Class ecardffiie.cibappi.LockedlP 



Object 

I 

+ Jd bcCbject: 

I 

+ ecardf ile . dbappl . LockediP 

public class LockediP 

extends JdbcObiect 

Yar/ai>fe ludey^^ 
CoffsPrucPor If/dey, 

^cardfile.dbappl.LockedIP (Connection) • 

J^ePhod Indgy^^ 

.QuervAllO 
•psAU 

protected java.sql.PreparedStatement psAll 

CotisPrucpors 

LockediP 

public LockediP (Connection connect) throws J dbcException 

M^P^odg 

•QueiyAll 

public java.util. Vector QueryAlK) throws JdbcException 
Overrides: 

Oiien'.-\ll in class JdbcObiect 
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Class ecareifile.dbappl.Lookup 



Object 
I 

+ JdbcCbiect 

+ ecardf ile . dbappl * Lookup 

public class Lookup 
extends JdhcObiect 

CoMsPrHCpor Ifi^eK 

^cardfile.d ha pplXookup (Connection) 

CoffsPrucpors 

^Lookup 

public Lookup {Connection connect) throws JdbcException 
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Class ecardfiie.dbappl.LookupCache 



Object 

i 

+ Cache 

i 

+ TableCache 

I 

+ ecardf ile.dbappl .LookupCache 

public class LookupCache 

extends T;ibleQche 
Cache of the Lookup table 
See Also: 

TableCiche 



s/ariakle Ifide-^ 

. .ADDRESS 
. EMAIL 
. PHONE 
. USERINFO 

CoMsPmcPor 

^cnrdfile.dbappLLookupCiche Q 

Shouldn*t use this constructor 
^cardfilc.dbappl.LookupCache (JdbcConnectionBroker2, long) 

Mephod i/fdeK 

^ addLbokupTokens (Short. Hashtable) 

Put the Lookup tokens in the token Hashtable 
• addVcardTokens (Short, Hashtable) 

Put the Vcaid tokens in the token Hashtable 
» getJdbcObject (Cbnnection) 

This method should be defined in the sub class, 
• populate Q 

The database table is populated by using a JDBC object created by 

getJdbcObject. 
» rg plac e L ookupT o ke ns (Shoru Strii^, int, Hashtable) 

Replace the Lookup tokens in the token Hashtable 
» ng plac e Vc a rdToke ns (Short. String, int, Hashtable) 

Replace the Vcard tokens in the token Hashtable 
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•ADDRESS 

public static final java. lang. Short ADDRESS 
•EMAIL 

public static final java. lang. Short EMAIL 
•PHONE 

public static final j ava . lang . Short PHONE 

•USERINFO 

public static final java. lang. Short OSERINFO 

CotisPrticPors 

^^LookupCache 

public LookupCache ( ) 

Shouldn't use this constructor 
^LookupCache 

public LookupCache ( JdbcCcnnect ior.Brcker2 connMgr, 

long sees) throws lOException 

Parameters: 

connMgr - - The JDBC Connection manager 
sees - - The cache is ^populated every 5et5 seconds 

•addLookupTokens 

public void addLookupTokens { Short category, 

Hashtable tokens) 
Put the Lookup tokens in the token Hashtable 
•addVcardTokens 

public void addVcardTokens ( Short category, 

Hashtable tokens) 
Put the Vcard tokens in the token Hashtable 
•getJdbcObject 

protected multiserv.dbmgr . JdbcObject getJdbcObject (Connection 
connect) throws JdbcExc ep tion 

This method shoixld be defined in the sub class. 

Overrides; 

getJdbcObject in class TableCache 
•populate 
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public void populate {) 

The database table is populated by using a JDBC object created by 
getJdbcObjecL We cdl populate from the super class then keep the data in 
an optimized form for local use. The form is as for a token table of the 

types. 
C>venides: 

populate in class TableCiche 

• replaceLookupTokens 

public void rep laceLookupTokens (Short category, 

String prefix, 
int allocatedRows, 
Hashtable tokens) 
Replace the Lookup tokens in the token I^ashtable 

• replace VcardTokens 

public void replaceVcardTokens (Short category, 

String prefix, 
int allocatedRows, 
Hashtable tokens) 
Replace the Vcard tokens in the token Hashtable 
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Class ecardfite.dbappl.PersonalList 



Object 

1 

+ JabcObj ect 

+ U serObject 

I 

+ ecardf ile . dbappl . PersonalList 

public class PersonalList 
extends UserObiect 

CoftBprMCPor 

i #ecandfile.dbapplPersomlList (Connection) 

•Delete (DatabaseConnection2, loi^, long) 
» De le te B\0 nil d (DaubaseConnection2. long) 

Note: Transaction shoiJd be setup around this method 
•Dele te B} Us e rl d (DatabaseConnection2. long) 

Note: Transaction should be setup around this method 
•lnsert(DatabaseCormectiori2, long, ior^, long, short) 
• I s Gi rdT he (long, long) 
•Que r\ Conti i ns Ci rd (long) 
•Que n;| oi uB) Use rl d (lQng) 
•Quer\ JolnB\ UserldName (long, char) 

ConsptMcPors 

^^PersonalList 

public PersonalList (Connection connect) throws JdbcExcept ion 

M^Pfiodg 

•Delete 

public int Delete {Dat abaseCcanection2 jdbc, 
long personalListId, 

long privateListId) throws JdbcException 

•DeleteByCaidId 

public int DeleteByCardId ( DatabaseC onnect ion2 jdbc, 

long cardid) throws JdbcException 
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Note: Transaction should be setup around this method 
•DeleteByUserid 

public int DeleteByUserid ( DatabaseCcnnecticn2 jdbc, 

•long userld) throws Jd bcExcep ticn 
Note: Transaction should be setup around this method 
•Insert 

public long Insert ( DatabaseCcnnecticnC jdbc, 

long listid, 
long userld, 
long cardid, 

short mask) throws JdbcHxcer t icn 

•IsCardThere 

public boolean IsCardThere {long userld, 

long cardid) throws JdbcException 

•QueiyContainsCaid 

piiblic java,util. Vector QueryContainsCarddong cardid) throws 

Jd bcExce p t icn 

• QueiyJoinByUseiid 

public java.util. Vector Query JoinByUser Id ( long userld) throws 

JdbcException 

• QueiyJoinByUseridName 

public java.util. Vector QueryJoinByUserldName (long userld, 

char lastlnitial) 

throws JdbcExceotion 
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Class ecarcKiile.dbappl.Phone 



Object 

I 

JdbcOb j ecc 

1 

+ UserOb;] ect 

I 

+ ecardf ile . dbappl . Phone 

public class Phone 
extends UserObiect 



^ Phone 

public Phone (Connection connect) throws JdbcExcepticn 




^ c a rdfile . dba ppL Phone (Connection) 
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Class ecarcifiie.dbappl.PrivateList 



Object 

+ JGbcOfcject 

+ UserObject 

I 

+ ecardf ile .dbappl .PrivateList 

public class Private List 

extends UserObiect 

CoffsPrncPor lude^ 

^cardfile.d hap pl.PrivateList (Connection) 

J^ephod IttdeK 

> DeleteB><:ardId (long) 
»Get(long, lor^) 
• Update Mask (long, short) 

CoMsPriiepors 

^^PrivateList 

piiblic PrivateList (Connection connect) throws JdbcExc e ption 

M^PMs 

•DeleteByCaidld 

piiblic long DeleteByCardlddong cardid) throws JdbcException 

•Get 

public java.util.Hashtable Get (long loginid, 

long cardid) throws JdbcException 

•UpdateMask 

public long UpdateMask ( long privateListId, 

short mask) throws JdbcException 
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Class ecardfiie.dbappl.User 



Object 

I 

+ JdbcObject 

i 

+ ecardf ile . dbappl .User 



public class User 
extends JdbcObiect 



^cardfile. dbappLUser (Gonnection) 

MePffod //fdix, 

» ConfimiUser (String. Strii^ 
•Delete (DatabaseConnection2, long) 
•Get(Stni^ 

• GetForLogin fString. String) 

•insert(DatabaseConnection2, StringQ, Vector, Vector, Vector) 
» Oiie vFirstLastName (String, String) 
• QuervByFirstLastNameSoundEx fString, String) 
•Update (DatabaseConnection2, StringQ, Vector, Vector, Vector) 

Cofisprueporg 

4*User 

public User (Connection connect) throws JdbcException 

M^P^ods 

•ConfimiUser 

public int ConfirmUser (String eCardId, 

String createld) throws Jd bcException 

•Delete 

public int Delete ( DatabaseConnection2 database, 

long userld) throws JdbcException 

•Get 

public java.util.Hashtable Get (String szECardId) throws 

JdbcExceptio n 

•GetForLogin 
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public java.util.Hashtable GetFor Login (String szECardId, 

String szPassword) throws 

JdbcException 

•Insert 

public long Insert ( DatabaseConnection2 database, 

String [] userRow, 
Vector addressRows, 
Vector phoneRows, 

Vector emailRows) throws JdbcExcepti cn 

• QueryByFirstLastName 

public java.util. Vector QueryByFirstLastName (String szFirstName, 

String szLastName) 

throws J<;ibc£xception 

• QueiyByFirstLastNameSoundEx 

public java.util. Vector QueryByFirstLastNameSoundEx (String 
szFirstName, 

String 

szLastName) throws JdbcExcep tion 

•Update 

public long Update { Databa£eConnection2 database. 

String [] userRow, 
Vector addressRows, 
Vector phoneRows, 

Vector emailRows) throws JdbcException 
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Class ecarcif!le.clbappI.Userinfo 



Object 

I 

+ JdbcObject 

+ UserOb:!ect 

+ ecardf ile . dbappl .Userinf o 

public class Userinfo 

extends UserObiect 

CoMsPmePor IndeK 

^cardfile.dhappl.UserIiifo (Connection) 

J^epkod IfidtK 

»Quen'ByCatcgon' (long, short) 
•Update (long, Vector) 

CofisPriiepors 

'^Userinfo 

public Userinf o (Connection connect) throws Jd bcException 

M^P^ods 

•QueryByCategoiy 

public java.util .Vector Que ryByCate gory (long cardid, 

short category) throws 

JdbcException 

•UpdatT 

public long Update (long userld, 

Vector rows) throws Jcb cExceptio n 
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Class ecardfiie.cibappi.UserObject 



Object 
I 

+ JdbcCbj ect 



+ ecardf ile . dbappl .UserObject 

public class UseiObject 

extends JdK'Obieci 

CoffBprMcPor 

^can3file,dbappl.UserObject (Connection, String, StringD, intQ, intQ) 

MeP^od /f/dgy, 

• DeleteByLse rid (long) 
» Inscrt (long, StringQ) 
# Qiier}ByUserId (int) 
» Quen'ByU$erId (long) 
•Update (long, String[D 

CoiisPmePors 

ii^UseiObject 

public UserObj ect (Connection connect, 
String table, 
String [] coluninNaines , 
int columnLength, 

int columnTypes) throws JdbcEx ception 

M^Pffods 

•DeleteByUseiid 

public long DeleteByUserld (long user Id) throws Jdbc Exception 

•Insert 

public long Insert (long userld, 

String [] row) throws JdbcE xceptio n 

•QueryByUseild 

public java.util .Vector QueryByUserld (int userld) throws 

Jd bc Except i ori 

•QueiyByUseiid 
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p\iblic java.util .Vector QueryByUserld (long userld) throws 

JdbcException . 

•update 

public long Update (long userld, 

String [] row) throws JdbcExc epticn 

Ovenides: 

Update in class JdbcObiect 
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Class ecarcKlie.cibappl.WhereAml 

Ob j ect 

I 

+ JdbcCb^ect: 



+ UserGb] ect 

+ ecardf i le . dbappl . WhereAmI 

public class WhercAmI 
extends Us'erObiect 

CoMsPnicPor 

^cardfile.dbapplAXlie re Ami (Connection) 

» G€t\\lthDate (long) 

» Qiien ByExpin (long, String) 

•Update (long, StringQ) 

Co^sPruePors 

'rf WhereAmI 

public WhereAmI (Connection connect) throws JdbcExcepticn 

M^Pftods 

•GetWithDate 

public java.util .Hash table GetWithDate ( long cardid) throws 

J dbcExcep t^ic n 

• Que lyByE xpiiy 

public java.util .Vector Que ryByExpiry (long cardid, 

String expDate) throws 

JdDcExcecticr. 

•Update 

public long Update (long userld, 

string [] row) throws JdbcExce p t ion 

Overrides: 

Update in class UserObiect 
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package murtiservappiserviet 

Class Index. 

• ApplSen'let 

• Applicationlnterface 

• RequesrHandler 

• SessionTable 
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Class muStisen/^appiservietJVppiServfet 



Object 
I 

+ GenericSeiTvlet 

i 

+ HttpServlet 

+ multiserv.applservlet .ApplServlet 

public class ApplServdet 
extends HttpSeivlet 

The base class for all Servlets which use the Multi Server/Multi Servlet . 
environment. Application servlets should extend this class. 

For most cases, only the getApplicationInterface() needs to be overridden so 
that it returns the appropriate application specific implementation of 
Applicationlnterface. 



CoHsPmePor lude^ 

^multisen.anpIsenleLApplSen-let Q 

jMPffodlifdeyC 

» dec rCume ntCount Q 
•destrnvQ 

•doGet(HttpServletRequest, fitpServletResponse) 

Overrides the doGet method provided by the HttpSen^let superclass. 
•doPost(HttpServletRequest, PfepSen^letResponse) 

Overrides the doPpst niethod provided by the HttpServlet superclass. 
> geL\pplicationInterface () 

Defines a method ^wWch returns an instance of j^plicationlnterface. 
> getPropert\' (String) 
• getSessioiLMgr Q 
» inc rCurrentCount O 
•init(ServletConfig) 

Called when the servlet first gets loaded 
•log (String) 

» setSessio!iMgrState (int) 
»trace (String) 

CofisPrHePors 

^ApplServdet 
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public ApplServletO 
•decrCurrentCount 

public synchronized void decrCurrentCount ( ) 

•destroy 

public void destroy () 
Overrides: 

destroy in class GeneiicServlet 
•doGet 

public void doGet (HttpServletRequest req, 

HttpServletResponse resp) throws 

ServletException, lOException 

Overrides die doGet mediod provided by die ffapServlet superclass. The 
serviceQ mediod of HpServlet handles die setup and dispatching to all 
doXXXO methods, which is why it usually shotild not be overriddea 
Parameters: 

req - The HTTP server request data. 

resp - Provides methods to respond to the request. 

Throws: ServletException 

a problem occurred during the processing of the request. 

Throws: lOException 

an I/O problem was encountered. 

Overrides: 

doGet in class HttpServlet 
See Also: 
doPost 
•doPost 

public void doPost (HttpServletRequest req, 

HttpServletResponse resp) throws 
ServletException, lOException 

Overrides the doPost method provided by the KfetpServ^let superclass. The 
service 0 method of HtpServlet handles the setup and dispatching to all 
doXXXO methods, which is why it usually should not be overridden. 
Parameters: 

req - Hie HTTP server request data. 

resp - Provides methods to respond to the request. 

Throws: ServletException 

a problem occurred during the processing of the request. 

Throws: lOException 

an I/O problem was encountered. 

Overrides: 
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doPost in class titpServlet 
See Ako: 

doGet 

• getApplicationlnterface 

piiblic multiserv.applservlet .Applicationlnterf ace 

getApplicationlnterface ( ) 

Defines a method wiiich returns an instance of Applicationlnterface. This 
must be overridden in a subclass to provide an instance of a class which 
inplements the methods defined in ^plicationlnterface. 

•getPiDperty 

public java.lang. String getProperty (String propName) 

•getSessionMgr 

public synchronized multiserv.sessionmgr.SessionMgr 
getSessionMgr 0 throws NotBoundException, RemoteException, 
MalformedURLException 

• inciCurrcntCount 

public synchronized void incrCurrentCount { ) 
•init 

public void init (ServletConf ig config) throws ServletException 

Called when the ser^let first gets loaded Do servlet initialization here. This 

specializes the initQ method in GenericServlet. 

Paiameters: 

config - servlet configuration information. 
Throws: ServletException 

a problem occurred during the initialization of the servlet. 
Overrides: 

init in class GenericServlet 

•log 

public void log (String msg) 
Overrides: 

log in class GenericServlet 
•setSessionMgiState 

piiblic synchronized void setSessionMgrState (int newState) 
•trace 

public void trace (String msg) 
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Class muEtisei^.applseivletJVppiicationlrite^ 



Ob j ect 



+ RemoteOb j ect 



+ Remotes erver 



+ Uni c a s t RemoteOb j ect 



multiserv.applservlet .Applicationlnterf ace 

public abstract class Applicationlnterface 
extends UnicastRemoteObject 
implements SessionObsen^er 

Encapsulates the application dependent operations which are invoked from the 
RequestHandler class. 



• access Denied (String. HtpServletRequest, HtpServletResponse) 

Called when a received request does not contain a valid session id. 
» a uthe ntic a te Us e r (String, String, HctpServletRequest) 

Authenticate the user xisir^ a user id and password combination, 
»chainReque$t (String. HttpServletRequest, JfapServletResponse) 

Method to forward a URL to another servlet. 
•checkAccess (HctpServletRequest) 

Qieck the HTTP request data and decide if access should be allowed 
»db_e nDr (HtpServletRequest, HttpServletResponse) 

A database error has occurred 
#db_error (PfopServletRequest, HtpServletResponse, String) 

A database error has occurred 
• destrpy Q 

Hook to get the Applicationlnterface to brush its teeth before goir^ to 
bed, 

»doc_ac c e s s_e nx)r (HttpServletReqiiest, HttpServletResponse) 

A document access error has occurred 
•execute Opera tion (String. String, Session, HctpServletRequest, 
ffepServletResponse) 

Called by RequestHandler to execute an application defined operation. 




^multis e rv,appls e nie t Applic ationi nte rfac e 0 
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» getOpcmrion (HttpServletRequest) 

Determine the type of operation to be invoked by the request. 
» getPasswond (HttpServletReqiiest) 

Get a string representii^ the user^s password 
> getPir>pert\^ (Striii^ 

• getSer\ietParaineter (HttpServletRequest. Strir^ 

Convenience method to extraa a parameter from a HctpServletRequesL 
» getScnietParameterValues (FfetpServletRequest String) 

Convenience method to a multi valiie parameter from a 

HctpServletRequesL 
• getSessionId (FttpServletRequest) 

Extract and return the session id from the original HTTP request. 
• getTimeZone Q 
• getUserld (titpServletRequest) 

Get a string representing the user identification 
•init(ApplServlet, String, String) 

Used to initialize the application specific class which implements this 

interface. 

# io_e mor (FfopServletRequest, HttpServletResponse) 

An io exception has occurred 
•log(String) 

» nfe_enDr (HttpSeryletRequest, HttpServletResponse) 

A NumberFormatException has occurred 
» nfe error (HttpServletRequest, HtpServletResponse, String) 

A NumberFormatException has occurred 
•nQtifv(SessionNotification) 

Override this method to be receive notifications from the Session 

Manner, 

> ns e_e mor (pjtpServletRequesL HtpServIetResponse) 

A non serializable exception has occurred • 
» postAuthenticate (String, Session, HctpServietRequest, HttpServletResponse) 

Post authentication functionality. 
# postDestrDy (HtpServletRequest, HtpServletResponse) 

Called by the RequestHandler immediately after the destruction of the 

session object. 

• pre De s tiDv (String, Session, FittpServletRequest, HttpServletResponse) 

Called by RequestHandler prior to the destruaion of the session object. 
» re_e rror (HttpServletRequest, HttpSen^letResponse) 

A Remote Exception has occurred 
• sae error (HttpServletRequest, titpServletResponse) 

A Session Access Exception has occurred 
•sendErTOr(FitpServletRequest, String, String, HttpServ^letResponse) 

General error handling routine. 
•sessionFaiiure (String, HttpServletRequest) 
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Notify the application that an attempt to access a session usmg sessionid 
failed 
> Lt3ce (String) 

^unknownOperation (HtpServletRequest, IfepServletResponse) 

An unknown operation has been requested 
> validat£Se$sion (String, Session, HttpServletRequest) 

Validate the passed session This method can also be used to implement 

any security checks or other checks such as if undesirables are accessing 

the site - such as SPAMMERS 

CoftsPrnepors 

^i^plicationlnterface 

public Applicationlnterface 0 throws RemoteException 
•accessDenied 

public abstract void accessDenied (String operation, 

HttpServletRequest req, 
HttpServletResponse resp) 

Called when a received request does not contain a valid session id. The 
application should return an error/ warning document to the user. 
Parameters: 

operation - the operation being performed 
req - the original HTTP request, 
resp - provides methods to respond to the HTTP server, 
f omiat - the http format to reply in 
•authenticateUser 

public abstract multiserv. sessionmgr .GenericSession 
authenticateUser (String userld, 
String password, 

HttpServletRequest req) throws Exception 

Authenticate the user using a user id and password combination. This 
method can also be used to implement any pre-session creation 
functionality. 
Parameters: 

userld - The user id string, 
password - The user's password string, 
req - The original HTTP request data. 
Returns: 

A session object containing any initial session data. The returned object 
must be a sub-class of GenericSession. This will be used to initialize the 
session object in the session manager. If the authentication fails, null is 
returned. 
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AchainRequest 

public void chainRequest (String servletUrl, 

HttpServletRequest req, 
HttpServletResponse resp) throws 
ServletException, lOException 

Method to forward a URL to another servleL This is kept as infrastructure 
so that it is easily changed to the most correct way of doing this. 
Parameters: 

sen^letUrl - TTie Servlet URL to which this request should be chained 
req - The HTTP request from the current servlet which is being forwarded 
on. 

resp - provides methods to respond to the HTTP server. 
Throws: ServletException 
Throws: lOException 
See Also: 

getServletParameter 
•checkAccess 

public abstract boolean checkAccess (HttpServletRequest req) 
throws Exception 

Qieckthe HTTP request data and decide if zccess should be allowed An 
application m^ht want to check the IP address or other paramters in the 
request. 
Parameters: 

req - The original HTTP request data. 
Returns: 

An indication if access is to be granted 
•dbertor 

public abstract void db_error (HttpServletRequest req, 

HttpSeirvletResponse resp) 

A database error has occurred 
Parametsers: 

fomiat - the predefined format to reply in 
resp - The HTTP response 
•dbertor 

public abstract void db_err or {HttpServletRequest req, 

HttpServletResponse resp. 
String msg) 

A daubase error has occimied 
Parameters: 

format - the predefined format to reply in 
resp - The HTTP response 
•destroy 

protected abstract void destroy () 
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Hook to get the Applicationlnterface to brush its teeth before going to 
bed 

• docaccessenor 

piiblic abstract void doc_access_error (HttpServletRequest req, 

HttpServletResponse resp) 

A document access error has occurred 
Parameters: 

format - the predefined format to reply in 
resp - The HTTP response 
•executeOperation 

public abstract void executeOperation (String operation. 

String sessionid. 
Session session, 
HttpServletRequest req, 
HttpServletResponse resp) 

Galled byRequestHandler to execute an application defined operation. 

Parameters: 

operation - Specifies the operation to perf omL This should be one of the 
operation strings returned by getOperation. 
session - An interface to the current session objecL 
sessionid - The session id strii^ for the current session, 
req - The data from the original HTTP request, 
resp - Provides methods for responding to the request. 
•getOperation 

public abstract java . lang . String getOperation (HttpServletRequest 
req) 

Determine the type of operation to be invoked by the request. Note that 

session creation and session destmction requests are indicated by the 

operation strings defined by RequestHandler.CRE ATE and 

RequestHandlerDESTROY respectively. 

Parameters: 

req - The HTTP request. 

Returns: 

A string describing the operation to carry out. 
•getPassword 

public abstract java . lang . String getPassword (HttpServletRequest 
req) 

Get a string representing the user's password 
Parameters: 

req - Hie original HTTP request data. 
Returns: 

A string containing the password. 
•getProperty 



88 



public java.lang. String getProperty (String propName) 

• getSenietPaiameter 

public java. lang. String getServletParameter (HttpServletRequest 
reg, 

String parmName) 

throws ServletException, lOException 

Convenience method to extract a parameter from a HtpServletRequest. 

The method first checks to see if die parameter came from another serv^let 

by trying to extract from the request using getAttributeQ. If this fails it 

uses getParameter to extract the parameter. This order of checking means 

that a calling servlet can override parameters. 

Parameters: 

req - The HTTP request 

parmName - The name of the parameter to extract 
Returns: 

The value of the parameter or null if not found 
Throws: ServletException 
Throws: lOExcepnon 
See Also: 

getServletParameter 

• getServietPaiameterValues 

public java. lang. String [] 

getServletParameterValues (HttpServletRequest req, 

String 

parmName) throws ServletException, lOException 

Convenience method to a multi value parameter from a 

HttpServletRequest. The method first checks to see if the parameter came 

from another servlet by trying to extract from the request using 

getAttributeO. If this fails it uses getParameterValues to extract the 

parameter. This order of checking means that a calling servlet can override 

parameters. The caller must be aware if the parameter is a multi value 

parameter. 

Parameters: 

req - The HTTP request 

parmName - The name of the parameter to extract 
Returns: 

The value of the parameter or null if not found 
Throws: ServletException 
Throws: lOExcepuon 
See Also: 

getServletParameter 
•getSessionId 
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public abstract java . lang , String getSessionId (HttpServletRequest 
req) throws Exception 

Extract and return the session id from the ordinal HTTP request. 

Paiameters: 

req - the original HTTP requesL 
Returns: 

the session id associated with the request. 
•getTimeZone 

protected java.util .TimeZone getTitneZone ( ) 
•getUserld 

public abstract java . lang. String getUserld (HttpServletRequest 
req) 

Get a string representing the user identification 
Parameters: 

req - The original Hl'lP request data. 
Returns: 

A string containing the user id. 

•init 

public void init ( ApplServlet applServlet, 
String managerName , 

String rmiHost) throws ServletException, 

lOException 

Used to initialize the application specific class which implements this 
interface. The servlet configuration is passed in so that the servlet 
environment is available to the application code. 
Parameters: 

applServlet - The Servlet instance which owns this Applicationlnterface 
instance. 

managerName - The name of the session manager instance to map. 
rmihost - The host on which the registr^^ is running 
•io error 

public abstract void io_error (HttpServletRequest req, 

HttpServletResponse resp) 

An io exception has occurred 
Parameters: 

format - the predefined format to reply in 
resp - The HI IP response 

•log 

public void log (String message) 
• nfe error 

public abstract void nfe_error (HttpServletRequest req, 

HttpServletResponse resp) 
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A NumberFormatException has occurred 
Parameters: 

format - the predefined format to reply in 
resp - The Hl'lP response 
•nfe_enor 

public abstract void nf e_error (HttpServletRequest req, 

HttpServletResponse resp, 
String msg) 

A NumberFormatException has occurred 

Parameters: 

format - the predefined format to reply in 
resp - The HTTP response 
msg - Additional info to be displayed 
• notify 

public void notify ( SessionNot if icat ion nofn) 

Override this method to be receive notifications from the Session 

Manager. 

Parameters: 

nofn - Interface which accesses notification information, 
•nseettor 

public abstract void nse_error (HttpSeorvletRequest req, 

HttpServletResponse resp) 

A non serializable exception has occurred 

Parameters: 

format - the predefined format to reply in 
resp - The HH P response 
•postAuthenticate 

public abstract void postAuthenticate (String sessionid. 

Session initialSession, 
_ HttpServletRequest req, 

HttpServletResponse resp) 

throws Exception 

Post authentication functionahty. This would probably include sending an 

HTML document back to the user. 

Parameters: 

* sessionid - a string identifying the new client session. 
initialSession - the new client Session object initialized with initial data, 
req - the original HTTP request. 

resp - provides methods to respond to the HTTP server. 
•postDestroy 

public abstract void postDestroy (HttpServletRequest req, 

HttpServletResponse resp) 
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Called by the RequestHandler iininediately after the destruction of the 

session object. 

Parameters: 

req - The data from the ordinal HTTP request, 
resp - Provides methods for responding to the request. 
•prcDesttoy 

public abstract void preDestroy (String sessionid. 

Session session, 
HttpServletRequest req, 
HttpServletResponse resp) 

Called by RequestHandler prior to the destmction of the session object. 

Parameters: 

sessionid - The session id string for the current session, 
session - An interface to the associated session object, 
req - The data from the ordinal fiTlP request, 
resp - Provides methods for responding to the request, 
•reenor 

public abstract void re_error (HttpSeirvletReguest req, 

HttpServletResponse resp) 
A Remote Exception has occurred 
Parameters: 

format - the predefined format to reply in 
resp - The Hl'lF response 
•saeenor 

public abstract void sae_error (HttpServletRequest req, 

HttpSearvletResponse resp) 

A Session Access Exception has occurred 
Parameters: 

format - the predefined format to reply in 
resp - The HTTP response 
•sendError 

public abstract void sendError (HttpServletRequest req, 

String msgl. 
String msg2 , 

HttpServletResponse resp) 
General error handling routine. This will force the class user to implement 
error messages 
Parameters: 
req - The HTTP request 
msgl - First mess^e to be displayed 
msg2 - Second message to be displayed 
resp - Hie HTTP response 
•sess ionFailure 
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public abstract boolean sessionFailure (String sessionid, 

HttpServletRequest req) 

throws Exception 

Notify the application that an attempt to access a sesssion using sessionid 
failed This could be due to a Bogus sessionid or an expired session. The 
application will decide if a new session is to be created or if accessDeniedQ 
should be called An application might want to log the failure or 
implement some sort of safeguard such as blocking the IP Address after a 
number of failures. 
Parameters: 

req - The original HTTP request data. 

sessionid - The session id string for the current session. 

Returns: 

If tme a new session will be created 

•trace 

public void trace (String message) 

• unknownOperation 

public abstract void unknownOperat ion (HttpServletRequest req, 

HttpServletResponse resp) 
An unknown operation has been requested 
Parameters: 

format - the predefined format to reply in 
resp - The HlTP response 
•validateSession 

public abstract boolean validateSession (String sessionid. 

Session session, 
HttpServletRequest req) 

throws Exception 

Validate the passed session This method can also be used to implement 
any security checks or other checks such as if undesirables are accessing 
the site - such as SPAMMERS 
Parameters: 

session - Tlie session to validate, 
req - The original HTTP request data. 
Returns: 

An indication if the session is valid 
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Class multisen/^applservletRequestHarKHer 

Object 

+ multiserv . applservlet . Request Handler 

public class RequestHandler 

extends Object 

A RequestHandler instance is created for each HTTP request received by the 

Application Servlet. 

yariakle //r</<?x 

^ CREATE 

The predefined operation types which can be executed by 

RequestHandler. 
^ DESTROY 
• appllnterface 

An instance of an application specific class which implements die 

Applicationlnterface 
♦ manage rName 

The name of the remote Session Manager being used 
♦operation 

Shows which operation this thread is executing 
♦ request 

Holds the data from the original HTTP request 
♦ response 

Provides methods for responding to the request 
♦ rmiHost 

The hosmame of the RMI registry 
•seniet 

The parent Servlet instance which created this RequestHandler 

CoMBprticPor Inde^ 

. multiserv^applserxietRequestHandler fString. String, ApplSeivlet, 
Applicationlnterface, HttpServletRequest, HttpServletResponse) 
The constmctor. 

♦ handle Q 

The method which implements the request handling functionality. 
♦ sessionMgr O 
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> scssionObjName (String) 

Constructs the session object name given the session id. 



•CREATE 

public static final j a va . lang. String CREATE 

The predefined operation types which can be executed by 
RequestHandier. All other operation types are application dependent and 
must be implemented using AppKcationlnterface (or extension thereof) 

•DESTROY 

public static final java* lang. String DESTROY 
•appUnterface 

protected multiserv.applservlet . Applicationlnterf ace 
appUnterface 

An instance of an application specific class which implements the 

AppKcationlnterface 
•managerName 

protected java . lang. St ring managerName 

The name of the remote Session Mans^er being used 
•operation 

protected java. lang . String operation 

Shows which operation this thread is executing 

• request 

protected javax. servlet .http .HttpServletRequest request 

HDlds the data from the original HTTP request 
•rcsponse 

protected javax. servlet .http.HttpServletResponse response 
Provides methods for responding to the request 

• miiHost 

protected j ava . lang . String rmiHos t 
The hostname of the RMI registry 

• serviet 

protected multiserv. applservlet . ApplServlet servlet 

The parent Servlet instance which created this RequestHandier 




-^RequestHandier 



public RequestHandier (String mgrName, 
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string rmihost, 
ApplServlet applServlet, 
Applicationlnterf ace appl, 
HttpServletRequest req, 
HttpServletResponse resp) throws 



RemoteException, MalformedURLException, NotBoundException 
The constructon Initializes the instances data members. 
Parameters: 

mgrName - The name of the session manager instance to map. 

raiihost - The host on \diich the registry is running 

applServlet - The parent ApplServlet instance. 

appl - The application specifics 

req - The request data from the HTTP server. 

resp - Provides methods for responding to the request. 

Tktows: RemoteException 

if registry could not be conucted. 

Throws: NotBoimdException 

if SessionMgr is not currently bound 



•handle 

public void handle () 

The method which implements the request handling functionality. This 
method processes requests and invokes the appropriate application leve 
methods in Applicationlnterface. 

•sess ionMgr 

protected mult i serv. sessionmgr. SessionMgr sessionMgrO throws 
NotBoundException, RemoteException, MalformedURLException 

• s e s s ionOb jName 

protected java. lang. String sessionObj Name (String sid) 
Constmcts the session object name given the session id. 
Parameters: 

sid - the session id string for the object 
Returns: 

a string containing the session object name or the empty string if sid is 




null. 
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Class muttiserv.applserviet.SessionTable 



object 
I 

+ Dictionary 

I 

+ Hashtable 

I 

+ tnultiserv.applservlet . SessionTable 

pubKc class SessionTable 
extends Hashtable 

A map containing the remote session object interfaces. Each interface is keyed 
using it's associated session id string, 

ComPmcPor lndeK 

^multisen^.applsenietSessionTable O 

MePmdMexT 

•getScssion (String) 

Retrieve a Session interface using the associated session id string. 
• putSe s s ion (Session. String) 

Insert a Session interface into the map using the associated session id as 

the key. 

Coffsprucpors 

SessionTable 

public" SessionTable ( ) 

M^Pffods 

•getSession 

public mult iserv. sessionnigr. Session getSession (String sessionid) 
Retrieve a Session interface using the associated session id string. 
Parameters: 

sessionid - The session id string. 
Returns: 

The Session interface keyed to the given session id or null if the key is 
invalid 
•putSession 

public void putSession(Session sess, 
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string sessionid) 
Insert a Session interface into the map usbg the associated session id as 
the key. 
Parameters: 

sess - The remote session object interface, 
sessionid - The session id string. 
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package multiserv.clbmgr 

Class Index 

• JdhcConnection 

• JdbcGonnertionBrQker2 

• JdbcConnectionFactory 

• JdbcObiect 

• Jdbc Vendor 

• TableCache 

• Timing 

t yt.ceppion IffdeK 

• JdhcException 
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Class multisei^.dbmgrJdbcConnection 

Object 

+ multiserv.dbTTigr. JdbcConnection 

pubKc abstract class JdbcConnection 

extends Object 

yariakle Mex, 

•debug 

CoMsPmcPor 

^multisen^d hm grJdbcConnection ri 

Default constructor only used for JdbcGonnectionFactor)^ 
vmultiserv,d bm gr,JdbcCQanection (String, String, String) 

J/{ePlfod lrtde\ 

•Connect(String, String, String) 

• Initialize Q 

>clearWamings O 

•close O 

• create State me nt O 

•g etConnection O 

•gednstance (String, String, String) 

• getWamings O 

• isClosed O 

• toString Q 

yariahles 

•debug 

public static boolean debug 

Cofisprticpors 

^JdbcConnection 

public JdbcConnection ( ) 

Default constructor only used for JdbcConnectionFactory 
--»Jdbc Connection 
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protected JdbcConnect ion (String URL, 

String username. 

String password) throws JdbcException 

•Connect 

piiblic boolean Connect (String URL, 

String usemame, 
String password) 

•Initialize 

protected abstract void Initialize () throws JdbcExcept ion 
•clearWamings 

public void clearWarnings ( ) throws SQLException 

•close 

public void close {) throws SQLException 
•crcateStatement 

public java, sql .Statement createStatement () throws SQLException 

•getConnection 

public java . sql - Connection getConnection ( ) 

•getlnstance 

public abstract multiserv, dbmgr .JdbcConnect ion 

getlnstance (String URL, String username, String password) throws 

JdbcE x cept ion 

•getWamings 

public java . sql . SQLWarning getWarnings ( } throws SQLException 

•isCIosed 

public boolean isClosedO throws SQLException 

•toStxing 

public java . lang . String toStringO 
Overrides: 

toString in class Object 
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Class multiserv.dbmgrJdbcConnectionBroke^ 

Obj ect 

+ mul t iseirv . dbmgr . JdbcConnectionBroker2 

public class JdbcConnectionBtoker2 

extends Object 
implements Runnable 

JdbcConnectionBroker2 A serviet-based broker for database connections. Creates 

and manages a pool of database connections. 

Version: 

L0.7 9/19/98 
Author 

Marc A. Mnich 



CoMsPrncPor Indeyi^ 

^ mu]tiserv.dbmgrJdbcConnectioiiBit)ker2 (String. String, String, String, 
JdbcConnection, int, int, String, double) 

Creates a new Connection Broker 

dbDriven JDBC driver. 

J^ePhod /ffdeK 

•destroyO 

Shuts down the housekeeping thread and closes all connections in the 
pool. 

• f e Co nnec tip n QdbcConnection) 

Frees a connection. 
•getAge (JdbcConnection) 

Returns the age of a connection -- the time since it was handed out to an 

application. 
♦ getConnecrion O 

This class hands out the connections in round- robin order. 
• idOfConne c tic n (JdbcConnection) 

Retums the local JDBC ID for a connection. 
• interrupt Q 

A hook for future expansion, 
•rcJeaseQ 

Release was method used in previous Connection Pool manager 

•runQ 

Housekeeping thread. 
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CoHsPrncpors 

^ Jdbc ConnectionBroke r2 

public JdbcConnectionBroker2 (String dbDriver, 

String dbServer, 
String dbLogin, 
String db Pas swords 
J dbcConnec t i on connection, 
int minConns, 
int maxConns, 
String logFileString, 
double maxConnTime) throws 

lOException 

Creates a new Connection Broker 

dbDriven JDBC driver, e.g. 'oiacle.jdbc.driver.OracIeDriver' 

dbServen JDBC connect string. e.g. 

jdbc:oracle:thin.^203.92.21.109:1526:on:r 

dbLogin: Database login name, e.g, 'Scott' 

dbPassword: Database password, e.g. 'Tiger' 

minConns: Minimvim niunber of connections to start with. 

maxConns: Maximum number of connections in dynamic pool. 

logFileString: Absolute path name for log file. e.g. 'crWtempW mylog.log' 

maxConnlime: Time in days between connection resets. (Reset does a 

basic cleanup) 

•destroy 

piiblic void destroy {) 

Shuts down the housekeeping thread and closes all connections in the 
pool Call this method from the destroyQ method of the servlet. 

•freeConnection 

public java . lang .String freeConnection ( JdbcConnection conn) 
Frees a connection. Replaces connection back into the main pool for 
resuse. 

•getAge 

public long getAge (J dbcConn ection conn) 

Returns the age of a connection - the time since it was handed out to an 

application. 
•getConnection 

public multiserv. dbmgr. JdbcConnection getConnection () 

TTiis class hands out the connections in round- robin order. This prevents a 
faulty connection from locking up an application entirely. A browser 
'refresh' will get the next connection wiaile the faulty cormection is cleaned 
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up by the housekeeping thread. If the min number of threads are ever 
exhausted, new threads arc added up the the max thread count. Finally, if 
all threads arc in use, this method waits 2 seconds and tries again, up to ten 
times. After that, it rctums a null. 
• idOfConnection 

public int idOfConnection ( JdbcConnect ion conn) 

Returns the local JDBC ID for a connection, 
•intemipt 

public void interrupt () 

A hook for future expansion. Currcntly it is used to interrupt the housekeeping 

thnead 
•release 

public void release (} 

Release was method used in prcvious Connection Pool manager 

•run 

public void run{) 

Housekeeping thrcad. Runs in the bacl^round with low CPU overhead. 
Connections are checked for warnings and closurc and are periodically 
restarted This thread is a catchall for corrupted connections and prevents 
the buildup of open cursors. (Open cursors result when the application 
fails to close a Statement). This method acts as fault tolerance for bad 
connection/ statement programming. 
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Class multiserv.dbmgr^dbcConriectionFactory 

Object 

+ multiserv.dbmgr. JdbcConnectionFactory 

public class JdbcConnectionFactory 

extends Object 

ConsPrMcPor Inde^ 

^multi$erv .dbmgr JdbcConnecrionFactory (JdbcConnection. String, String, 
String) 

J^ePhod IfideK 

• getCoiinection Q 

CoMsPrucPors 

-^JdbcConnectionFactoty 

public JdbcConnectionFactory ( JdbcCo nnec t ion connection, 

String URL, 
String username. 
String password) 

•getConnection 

public multiserv.dbmgr. JdbcConnect ion getConnection ( ) throws 

JdbcException 
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Class murtiserv.dbmgrJdbcObject 



Object 

I 

+ multiserv . dbmgr . JdbcObj ect 



public class JdbcObject 

tSc b^e^r aJdbcObjea. When specifying the column names the tableld, if used, must be specified as the first column 
tabid± E.g. For a table called l^ere and there is an id column it must be specified as the first column as Vsersld 



yariable lfide\ 

• COLUMNS 

• COI.UMNSJNSERT 

■ DEBUG 

• INSERTS 

• UPDATE S 

•VALUES 

•connect 

•pj 

»ps.\ll 

•psBvia 

•ps Delete 

•ps Insert 

•psM axId 

•pi> U pdate 

• ps Update Check 

ConsPrucPor Mx. 

^miih ise n-.dbmgr.J dbcObi ect fConncction, Stnng, StnngH intO, iniO 

MeP^od Irtdey, 

• Delete (Long) 
•Execute 0 
•GetO 

•Get(lor^ 

•Insejt(String[]) 

•Quoo^O 

»Quen:AlJO 

•Tabl e Name Q 

•Update (long, Stringj]) 

•Updat e Check (long, long, StnngQ) 

•Upd ate Row (String 

•g etQ)iumnNam es Q 

•*^etColumn String (int) 

Generate a string containing the column names given a particular operation type. 

•j: t.* lO) 1 y nioT^pil5 0 

•getRow(ResultSet, ResultSetMetaData, int) 

•columns 
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protected static final int COLUMNS 

• COLUMNS_INSERT 

protected static final int COLUMNS^INSERT 

•debug 

public static boolean DEBUG 
•inserts 

protected static final int INSERTS 

•updates 

protected static final int UPDATES 
•values 

protected static final int VALUES 

• connect 

protected java.sql. Connect ion connect 



protected java. sql . PreparedStatement ps 

• psAU 

protected java. sql . PreparedStatement psAll 

• psByld 

protected j ava - sql , PreparedStatement psByld 

• ps Delete 

protected j ava . sql . PreparedStatement psDelete 

• ps Insert 

protected java . sql . PreparedStatement psinsert 

• psMaxId 

protected java . sql . PreparedStatement psMaxId 

• ps Update 

protected java . sql . PreparedStatement psUpdate 

• ps Update Check 

protected java . sql . PreparedStatement psUpdateCheck 



ps 




•"^JdhcObject 



public JdbcObject (Connection connect, 



string table. 

String [] columnNames, 

int columnLength, 

int columnTypes) throws JdbcException 
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• Delete 

public long Delete {long id) throws JdbcException 

• Execute 

public long Execute () throws JdbcException 
•Get 

public java.util.Hashtable GetO throws JdbcException 

• Get 

public java.util.Hashtable Get (long lid) throws JdbcException 

• insert 

public long Insert (String [] row) throws JdbcException 

• Oueiy 

public java.util .Vector Query {) throws JdbcException 

• OueiyAll 

public java.util. Vector QueryAllO throws JdbcException 
•TableName 

public java.lang. String TableName (} 
•'Update 

public long Update (long id, 

String [] row) throws JdbcExcepti on 

• UpdateCheck 

public long UpdateCheck (long id, 

long checkid, 

String [] row) throws JdbcExc ep tion 

• update Row 

public long UpdateRow (String [] row) throws JdbcException 

• getColumnNames 

public java. lang. String [] getColumnNames ( ) 

• getColumnString 

public java. lang. String getColumnString (int iType) 

Generate a stnng containing the column names given a particular operation type. Valid operation types are: 

COLUMNS 

All of the columns 

COLUMNSJNSERT 

Columns for an insert. Note that this will not include the tableld column if JdbcVendor.SUPPORT_ip is 

turned on 

UPDATES 

Columns for an update. Note that this will not include the tableld column if JdbcVendonSUPPORT_ID is 

turned on 

VALUES 

Columns for a VALUES clause of an INSERT statement. Note that this will not include the tableld column if 
JdbcVendonSUPPORT ID is turned on 
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Paxameteis; 

iType - Indicate the operation type for T^iiich the column string is beir^ generated 
^ getCoIumnTypes 

public int[] getCoIumnTypes ( ) 
^getRow 

public java.util .Hashtable getRow{ResultSet results, 

ResultSetMetaData meta, 
int cols) 



All Packages Class Hierarchy This Package Previous Next 
Index 
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Index 



Class muitiserv.dbmgrJdbcVendor 



Object 

+ multiserv . dbmgr . JdbcVendor 



public class JdbcVendor 
extends Objea 

All of the vendor specific stuff goes in here. Things like supporting an autoniacically incren^ntbg row id colunm. Edit this 
file and reconipile .„ yuk! 



yariai'le iMde-^ 

• PUP INDEX 
• DUP_ VALUE 

INFORMIX When inseitir^ a row and a unique column constraint is violated this is the error code returned in 
getErrorOxleO from the SQLException 
•SUPPQRIJD 

Some call it SERIAL (eg Infoimix), some call it IDENTITY others just don't have it, 

CoMsPrucPor Indey^ 

vmulusen,dbmg!.Jdbc\ endorQ 

J^ePffod lrtde\ 

»du plicatelnde\ (SQLException) 
(PreparedStatement) 

• k no v\-nE rro r (SQLException) 

» s etL o c kM o d e \X 'a it (Conneaion, int) 

• dUP INDEX 

public static int DUP_INDEX 

• DUP VALUE 

public static int DUP_VALUE 

INFORMIX When inserting a row and a unique column constraint is violated this is the error code returned in 
getErrorOxleO from the SQLException 

• SUPP0RT_ID 

public static boolean SUPPORT_ID 

Some call it SERIAL (eg Informix), some call it IDENTITY others just don't have it. Its a column which 
automatically creates a senal id for a row. Postgres doesn't have it but come to thing of it there is another sort of 
Id for a row - the details escape me at the moment but that could be an option in the Postgres rather than the 
getNextldO method 

Cotfsprucpors 

'^JdbcVendor 
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public JdbcVendorO 
© duplicatelndex 

public static boolean duplicatelndex (SQLExcept ion e) 
• getid 

public static long getId ( PreparedStatement pStmt) throws 

SQLExcept ion 

^knownError 

public static boolean knowxiError (SQLExcept ion e) 
^ setLockModeWait 

public static boolean setLockNodeWait (Connection connect, 

int seconds) throws • 

JdbcException 



All Packages Class Hierarchy This Package Previous Nex t 
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Index 



Class muKiserv.dbiTtgr.TableCache 



Object 

I 

+ Cache 

I 

+ multiserv. dbmgr .TableCache 



public abstraa class TableCache 
extends Cache 

This class provides a base class for caching a JdbcObjea. Subclasses simply need to override the 

getJdbcObjea(Connettion) niethod 

Version: 

Sid: TableCache.java,v lA 1999/12/03 19:42:22 peter Exp $ 

See Also: 

getJdbcObjea, Cach e 



CoHsPtHcPor 

v multisen.dbmgr.TableC acheQ 

vT niiltl.serv .dbm grTableCic he 0dbcConnectionBroker2) 
vm u llis e I'v . d b i n g \\X a b Ic cite QdbcConnectionBroker2, long) 

»getj d be O bject (Conneaion) 

This method should be defined in the sub class. 
♦gei Ro\\ (Iong) 

Retrieve a row from the cached table by specifying the row id 
♦po pulate Q 

The database table is populated byusing a JDBC object created by getJdbcObject. 
♦ re initial 17 e Q 
•n^lOjiulateO 

Simply calls populate. 
» s etConnMa na g e r (JdbcConneaionBroker2) 

Co/fsPtftcpors 

-^TableCache 

public TableCache 0 
^TableCache 

public TableCache ( Jdbc Connect ionBroker2 connMgr) throws 
lOException 

Parameteis: 

connMgr - - The JDBC Connection broker 
-^TableCache 

public TableCache ( JdbcConnect i onB x^oker2 connMgr, 
long sees) throws lOException 

Parameters: 

connMgr - - The JDBC Conneaion broker 
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sees - - The cache is repopukced every sees seconds 
• getJdbcObject 

protected abstract multiserv.dbmgr . JdbcObject 
getJdbcObject (Connection connect) throws JdbcException 

This method should be defined in the sub class. It should just create an instance of a subclasses JdbcObject, 

passing it connect 

Parameters: 

connea - Database connectioa 

^^ getRow 

public java.util.Hashtable getRow(long id) throws CacheException 
• Retrieve a row from the cached table by specifying the row id 
Parameters: 

id - The id of the row to be retrieved. 
Returns: 

Hashuble as returned by a JdbcObjea single row query. 
Thmws: Cache Except ion 
- row not found in Cache 
populate 

public void populate 0 

The database table is populated by using a JDBCobjea created by getJdbcObjea. 
Overrides: 

popubie in class Oche 
© reinitialize 

public void reinitialize ( ) 
Overrides: 

KJimi'lIi^e in class Ciche 
^ repopulate 

public void repopulate ( ) 

Simply calls populate. Obviously want to have a long cache check time. Could put in some sort of check to see 

when the table was last updated but this would be some sort of Vendor specific hook. 

Overrides: 

re populate in class Oche 
^ setCormManager 

public void se t ConnManager ( Jdbc Conne c t i onB r oke r 2 connMgr) 
Parameters: 

connIv%r - - The JDBC Connection broker 
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Class multiserv-dbmgr.Timing 

Object 

+ mul tiserv . dbmgr , Timing 

public class Timing 
extends Object 

CoHsPrtiePor lndeK 

^multise rv.dbmgnTiming () 

/^eP/tod f/fdex. 

♦ LogTiming (String) 

CoMsPrucpors 

->Tiniii^ 

public Timing 0 

•LogTiming 

public void LogTiming (String szMessage) 
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Class multiserv.dbmgrJdbcException 



Object 

I 

+ Throwable 

I 

+ Exception 

I 

+ SQLException 

I 

+ multiserv . dbmgr . JdbcException 

public class JdbcException 

extends SQLException 

CoMsPrMCPor iHde^ 

^multiserv.dbmgrJdbcExccption O 

^ multise rv.dbmgr J dbc E xception fString) 

^multis e tv.dbmgr J dbc E xc e ption fString. String, int) 

J^epkod lilde\ 

» isDuplicate Value 0 

CoffsPrtiepors 

^JdbcException 

public JdbcException ( ) 

^JdbcException 

public JdbcExceptionrtString s) 
-^JdbcException 

public JdbcException (String message. 

String state, 
int error) 

M^Pkods 

• is Duplicate Value 

public boolean isDuplicateValue ( } 
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package muKisen/Lsessionmgr 

Ifiperface iMdeyi^ 

• Session 

• SessionMgr 

• SessionNotification 

• SessionObserver 

• SessionTags 

class lifdeK 

• GenericSession 

• NotificationData 

• Obser\^erA4ap 

• SessionExpirer 

• SessionldFactoty 

• Sessionlmpl 

• SessiooMap 

• SessiorLMgrConnection 

• SessiQnA4grImpl 

• SessionA^gi-ShutdowTi 

• SocketHandler 

t \cepPioH Mey, 

• SessionAccessException 
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interface multiserv-sessionmgr.Session 



public abstract interface Session 
extends Remote 

The Session remote mterface is used to access the Sessionlmpl objects within the 
session manager. 

^ expire Q 

Mark this object as expired 
• getPouble (String) 

Get the value of a double precision floating point field within the 

associated Sessionlmpl instance. 
» gctInt (String) 

Get the value of an integer type field within the associated Sessionlmpl 

instance. 
» getLastAccessed () 

Get the time at which this instance was last accessed. 
•getLong(String) 

Get the value of a long integer field within the associated Sessionlmpl 

instance. 
» getObject (String) 

Get the value of a field within the associated Sessionlmpl instance. 
♦ hasExpired Q 

Determine if this object has expired 
•setDouble (String, double) 

Set the value of a double precision floating point field within the 

associated Sessionlmpl instance. 
•setInt(String, int) 

Set the value of an integer type field within the associated Sessionlmpl 

instance, 
•sed^ong (String, long) 

Set the value of a long integer field within the associated Sessionlmpl 

instance. 
» sctObject (String, Object) ' 

Set the value of a field within the associated Sessionlmpl instance. 
•touchO 

Mark the time when this object was last accessed as now. 
•expire 
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public abstract void expire () throws RemoteException 

Mark this object as expired 
•getDouble 

public abstract double getDouble (String fieldName) throws 
SessionAccessException , RemoteException 

Get the value of a double precision floating point field within the 

associated Sessionlmpl instance. 

Parameters: 

fieldName - A string specifyir^ the name of the field to set. 
Returns: 

The value of the field 
Throws: SessionAccessException 
Field doesn't exist or is private. 
Throws: RemoteException 
Commianications error, 
•getint 

public abstract int getint (String fieldName) throws 
SessionAccessException , RemoteException 

Get the value of an integer type field within the associated Sessionlmpl 

instance. 

Parameters: 

fieldName - A string specifying die name of the field to set. 
Returns: 

The value of the field 
Throws: SessionAccessException 
Field doesn't exist or is private. 
Throws: RemoteException 
Communicauons error. 
•getLastAccessed 

public abstract long getLastAccessed ( ) throws RemoteException 
Get the time at which this instance was last accessed 
Returns: 

the time in milliseconds since EPOCH when this object was last accessed. 
•getLong 

public abstract long getLong (String fieldName) throws 
Sessio nAcces sExce ptio n , Remot eExcep t ion 

Get the value of a long integer field within the associated Sessionlmpl 

instance. 

Parameters: 

fieldName - A string specifying the name of the field to set. 
Returns: 

Hie value of the field. 

Throws: SessionAc cessExcepiion 
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Field doesn't exist or is private. 
Throws: RemoteException 
Communications error. 
•getObject 

public abstract java.lang. Object getObject (String fieldName) 
throws SessionAccessException , RemoteException, 
NotSerializableException 

Get the value of a field within the associated Sessionlmpl instance. The 

field type must be an extension of Object and must also inclement the 

Serializable interface. 

Parameters: 

fieldName - A strir^ sf>ecifying the name of the field to set. 
Returns: 

The value of the field. 
Throws: SessionAccessException 
Field doesn't exist or is private. 
Throws: RemoteException 
Communications error. 
Throws: NotSerializableException 
value doesn't implement Serializable 
•hasExpired 

public abstract boolean hasExpiredO throws RemoteException 
Determine if this object has expired 
Returns: 

true if the object has expired, false otherwise. 
•setDouble 

public abstract void setDouble (String fieldName, 

double value) throws 
SessionAccessException , RemoteExcep t ion 

Set the value of a double precision floating pobt field within the 

associated Sessionlmpl instance. 

Parameters: 

fieldName - A string specifying the name of the field to set. 
value - The value to set the field to. 
Throws: SessionAccessException 
Field doesn't exist or is private. 
Throws: RemoteException 
Communications error, 
•setint 

public abstract void setint (String fieldName, 

int value) throws 
SessionAccessE xception , RemoteException 
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Set the value of an integer type field within the associated Sessionlmpl 

instance. 

Parameters: 

f ieldName - A strii^ specifying the name of the field to set. 
value - The value to set the field to. 
Throws: SessionAccessException 
Field doesn't exist or is private. 
Throws: RemoteException 
Communications error. 
•setLong 

public abstract void setLong (String f ieldName, 

long value) throws 
SessionAccessException , RemoteException 

Set the value of a long integer field within the associated Sessionlmpl 

instance. 

Parameters: 

f ieldName - A string specifying the name of die field to set. 
value - The value to set the field to. 
Throws: SessionAccessException 
Field doesn't exist or is private. 
Throws: RemoteException 
Communications error. 
•setObject 

public abstract void setObject (String f ieldName, 

Object value) throws 
SessionAccessException , RemoteExcept ion , 
NotSerializableException 

Set the value of a field within the associated Sessionlmpl instance. The 

field type must be an extension of Object and must also implement the 

Serializable interface. 

Parameters: 

fieldName - A string specifymg the name of the field to set, 
value - The value to set the field to. 
Throws: SessionAccessException 
Field doesn't exist or is private. 
Throws: RemoteException 
Communications error. 
Throws: NotSerializableException 
value doesn't implement Serializable 
•touch 

public abstract void touch ( ) throws RemoteException 
Mark the time when this object was last accessed as now. 
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interface mul1tiserv.sessionmgr.SessionlVlgr 



public abstract interface SessionMgr 
extends Remote 

The SessionMgr remote interface is used to control the session manager. 



•cioseSession(String) 

Remove an existing Sessionlmpl object from the session manner. 
• initSes s ion (Session) 

Create a new Sessionlmpl object within the session manager, 
• regi$ter (String) 

A remote entity registers interest in events taking place within the session 

manager by calling this method 
• sessionldList Q 

Return an array containing all the current Session object identifiers. 
•shutdown(String) 

A remote entity inf omis the Session Manager that it is prepared to have 

the Manager shutdown operations. 
•unregister(String) 

A remote entity calls this method to stop further notifications being sent 

by the session manager. 



•closeSession 

public abstract void closeSession {String • sessionid) throws 
RemoteException, MalformedURLException, NotBoundException 

Remove an existing Sessionlmpl object from the session manager. 

Parameters: 

sessionid - A string which identifies the session to be removed. 

Throws: RemoteException 

if some communication failure occurs. 

Throws: NotBoundException 

the session which is being closed does not have it*s interface bound to the 
RMI registry. 
• initSession 

public abstract java . lang. String initSession (Se ssi on session) 
throws RemoteException, MalformedURLException, 

o nAccess Exc ep t ion , NotSeriali zab 1 eExcep t i on 

Create a new Sessionlmpl object within the session manager. 

Parameters: 
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session - Contains the initial session data. 
Returns: 

A string used to identify the new session in subsequent accesses to the 
session manager. 
Throws: RemoteException 
if some communication failure occurs, 
•register 

p\iblic abstract void register (String id) throws RemoteException 
A remote entity registers interest in events taking place within the session 
manager by calling this method After registering the session manager can 
notify the entity via the Servlet's SessionObserver interface. 
Parameters: 

id - A unique string identifying the registering entity 
Throws: RemoteException 
if some communication failure occurs. 
•sessionldList 

public abstract java.util .Vector sessionldList ( ) throws 
RemoteException 

Retum an array containii^ all the current Session object identifiers. 

Returns: 

A Vector instance containing the Session object id's. 
Throws: RemoteException 
if some communication failure occurs, 
•shutdown 

public abstract void shutdown (String id) throws RemoteException 
A remote entity informs the Session Manager that it is prepared to have 
the Manager shutdown operations. The Session Manager will shutdown 
operation as soon as it receives shutdown notifications from all registered 
entities. 
Parameters: 

id - A unique string identifying the entity 
Throws: RemoteException 
if some communication failure occurs, 
•unrcgister 

public abstract void unregister (String id) throws 
RemoteException 

A remote entity calls this method to stop further notifications being sent 

by the session manager. 

Parameters: 

id - A unique string identifying the entity. 

Throws: RemoteException 

if some communication failure occurs. 
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Interface 



muitisei^.sessionmgr.SessionNotifk:ation 

public abstxaa interface SessionNotification 

Provides the interface through which the Session Manager can transfer 
notification data. Any class which implements this interface must also implement 
interface java.io.Serializable. 

yariahle Iffdey^ 

.MANAGE RRE LOAD 
.MANAGE R RUNNING 
. MANAGE R SHUTDOWN 
.MANAGE RSTOPPING 
.SESSION EXPIRATION 

•reasonO 

Returns an integer code representing the reason for the notification, 
♦ sessioiiId O 

Returns a string giving the session id for the Session object which caused 
the notification to be issued 
•sessjonObjO 

Returns a reference to a copy of the Session object which this 
NotificationData instance relates to. 

•MANAGER RELOAD 

public static final int MANAGER_RELOAD 
•MANAGERRUNNING 

public static final int MANAGER_RUNNING 
• MANAGER SHUTDOWN 

public static final int MANAGER_SHUTDOWN 

•MANAGER_STOPPING 

public static final int MANAGER_STOPPING 
•SESSION EXPIRATION 

public static final int SESSI0N_EXPIRATION 
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•rcason 

public abstract int reason {) 

Returns an integer code representing the reason for the notification. In 
general, these integer codes will be application dependent. 

•sessionid 

public abstract java. lang. String sessionid {) 

Returns a string giving the session id for the Session object which caused 
the notification to be issued This will return null if the notification is not 
connected with any Session object. 

•sessionObj 

public abstract multiserv. sessionmgr. Session sessionObj () 
Returns a reference to a copy of the Session object which this 
NotificationData instance relates to. For example, if this is a session expiry- 
notification then this method will return a reference to a copy of the 
Session object which was removed from the Session Manager. 
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interface multisei^iSessionmgrSessionObserver 



public abstract interface SessionObserver 
extends Remote 

Provides the interface via which the Session Manager can notify remote entities. 

» notify (SessionNotification) 

Galled by the Session Manager to notify the entities which implement this 
interface. 

• notify 

public abstract void notify ( SessionNotif ication nofn) throws 
RemoteException 

Called by the Session Manager to notify the entities which implement this 

interface. 

Parameters: 

nofn - Interface which accesses data relating to the notification. 

Throws: RemoteException 

if some communication failure occurs. 
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Interface muJtiserv.sessionmgr.SessionTags 

pubKc abstxact interface SessionTags 
Defines the constants used for basic sessions 



> APPL_OPERATION 
, BROWSER_TAG 
.BROWSER TOKEN 
> COMMENT_TOKEN 
. COMPUTER TAG 
. COMPUTER TOKEN 
. CONNECTION TAG 
. CONNECTION TOKEN 
. COOKIE TAG 
. DATETOKEN 
. DOCNAME TAG 
. EMAILTAG 
. END TOKEN 
. GUCTOKEN 
. LC OPT PREFIX 
. LOGINTAG 
. LOGOUTOP 
. MSGl_TOKEN 
. MSG2 TOKEN 
. NAME TAG 
. NAME TOKEN 
. OPT PREFIX 
. OP TAG 
. OPTOKEN 
. PASSWORD TAG 
. SESSIONIDTAG 
. SESSIONIDTOKEN 
. SESSACTIVETAG 
. SESS_ID_TAG 
. SESSJPADDRTAG 
. SESS START TAG 
. SESS USE RID TAG 
. SESS USER TAG 
. SPEEDTAG 
. SPEED TOKEN 
. START TOKEN 
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. STATUSTOKEN 
. TERMINATE TAG 
. TIMEOUT TAG 
.TIMEOUT TOKEN 
. TIME TOKEN 
. TYPETAG 
. TYPE TOKEN 
. URL TAG 
. URL TOKEN 
. USERIDTAG 

The following constants define the HTML tags which are used to identify 
data fields. 
.USERNAME TAG 

•APPL_OPERATION 

piiblic static final java. lang. String APPL_OPERATION 

•BROWSER_TAG 

public static final j ava . lang . String BROWSER_TAG 
•BROWSER TOKEN 

public static final java . lang. String BROWSER_TOKEN 

•COMMENT TOKEN 

public static final java. lang. String COMMENT_TOKEN 

•COMPUTER_TAG 

public static final java. lang. String COMPUTER_TAG 
•COMPUTERTOKEN 

public • static final java. lang. String COMPUTER_TOKEN 
•CONNECTION TAG 

public static final java . lang. String CONNECTION_TAG 

•CONNECriON_TOKEN 

public static final java. lang. String CONNECTION_TOKEN 
•COOKIE TAG 

piiblic static final java . lang. String COOKIE_TAG 

•DATE_TOKEN 

public static final java. lang. String DATE_TOKE» 
• DOCNAME TAG 

public static final java. lang. String DOCNAME_TAG 
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•EMAIL TAG 

public static final j ava . lang . String EMAIL_TAG 

•END TOKEN 

piiblic static final j ava . lang . String END_TOKEN 
•GUC_TOKEN 

public static final j ava . lang . String GUC_TOKEN 

•LC_OPT_PREFIX 

public static final j ava . lang . String LC_OPT_PREFIX 
•LOGINTAG 

piablic static final j ava . lang . String LOGIN_TAG 

•LOGOUT OP 

public static final j ava. lang. String LOGOXJr_OP 

•MSGl TOKEN 

public static final j ava . lang . String MSG1_T0KEN 
•MSG2 TOKEN 

public static final j ava . lang . String MSG2_T0KEN 

•NAMETAG 

public static final java. lang. String NAME_TAG 
•NAMETOKEN 

public static final java. lang. String NAME_TOKEN 
•OPT PREFIX 

public static final java. lang. String OPT_PREFIX 

•OP_TAG 

public static final j ava . lang . String OP_TAG 

•OP TOKEN 

public static final java. lang. String OP_TOKEN 
•PASSWORDTAG 

public static final java . lang , String PASSWORD_TAG 

•SESSIONID TAG 

public static final java . lang, String SESSIONID_TAG 
• SE SSIONIDTOKE N 

public static final java . lang . String SESSIONID_TOKEN 

•SESS_ACriVE_TAG 
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public static final java . lang . String SESS_ACTIVE_TAG 

•SESSJD TAG 

public static final java . lang. String SESS_ID_TAG 
•SESSJP_ADDR_TAG 

public static final j a va . lang . String SESS_IP_ADDR_TAG 

•SESS START TAG 

piiblic static final java . lang. String SESS_START__TAG 

•SESS_USER ID TAG 

public static final java . lang . String SESS_USER__ID_TAG 

•SESSUSERTAG 

public static final java. lang. String SESS_USER_TAG 

•SPEEDTAG 

public static final java. lang. St ring SPEED_TAG 
•SPEEDTOKEN 

public static final java. lang. String SPEED_TOKEN 
• START TOKEN 

public static final java . lang. String START_TOKEN 

•STATUSTOKEN 

public static final java . lang . String STATUS_TOKEN 

•TERMINATE TAG 

p\iblic static final java . lang . String TERMINATE_TAG 

•TIMEOUT_TAG 

public static final java . lang . String TIMEOUT_TAG 

•TIMEOUT_TOKEN 

p\iblic static final java . lang . String TIMEOUT_TOKEN 

•TIMETOKEN 

pxiblic static final java. lang. St ring TIME_TOKEN 

•TYPE TAG 

public static final java . lang . String TYPE_TAG 

•TYPE TOKEN 

public static final j ava . lang . String TYPE_TOKEN 

•URLTAG 

public static final java . lang . String URL__TAG 

•URLTOKEN 
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public static final java . lang. String URL_TOKEN 

•USERIDTAG 

public static final java. lang. St ring USERID_TAG 

The following constants define the HTML tags which are used to identify 
data fields. This file could possibly be generated automatically from or 
along with the HTML documents themselves. 

•USERNAMETAG 

public static final java . lang . String USERNAME_TAG 
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Class multiserv.sessionrngr.GerieiicSession 



Obj ect 
I 

+ RemoteObject . 

I 

+ RemoteServer 

I 

-t- UnicastRemoteObject 

1 

+ 

mult iserv . sessionmgr . GenericSession 

public class GenericSession 
extends UnicastRemoteObject 
implements Session , Serializable, Qoneable 

yariakle lrtde\ 

^ expired 
•lastAccessed 

CoMsPrficPor 

^ multjserv.sessioamgr.GencricSession O 

• cxpire O 

Mark this objea as expired 
•getDoubk (String) 

Get the value of a double precision floatir^ point field within the 

associated Sessionlmpl instance. 
# getInt (String) 

Get the value of an integer type field within the associated Sessionlmpl 

instance. 
• getLastAcccssed O 

Get the time at which this instance was last accessed 
•getLong (String) 

Get the value of a long integer field within the associated Sessionlmpl 

instance. 
» getQbjcct (String) 

Get the value of a field within the associated Sessionlmpl instance. 
♦ hasExpited O 

Determine if this object has expired 
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• sessionFailure (Exception) 

General exception handler for the session object 
•sess 10 iiFailutig (String. Exception) 

General exception handler for the session object 
• setDoublc (String, double) 

Set the value of a double precision floating point field within the 

associated Sessionlmpl instance. 
• setInt (String, int) 

Set the value of an integer type field within the associated Sessionlmpl 

instance, 
•setLong (String, long) 

Set the value of a long integer field within the associated Sessionlmpl 

instance, 
• setObject fString. Object) 

Set the value of a field within the associated Sessionlmpl instance, 
•touch () 

Mark the time when this object was last accessed as now. 

yan'aHes 

•expircd 

protected boolean expired 

•lastAccessed 

protected long lastAccessed 

CoMsPrMcPors 

^GenericSession 

public GenericSession { ) throws RemoteException 

•expire 

public void expire ( ) throws RemoteException 

Mark this object as expired 
• getJDouble 

public double getDouble (String fieldname) throws 
Sess lonAc cessExc epj: i on 

Get the value of a double precision floating point field within the 

associated Sessionlmpl instance. 

Parameters: 

f ieldName - A string specifyii^ the name of the field to set. 
Returns: 

The value of the field. 

Throws: SessionAccessException 
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if therc wzs a problem accessing the fields value, 
•getint 

public int getint (String fieldName) throws 

SessionAccessException 

Get the value of an integer type field within the associated Sessionln^l 

instance. 

Parameters: 

fieldName - A string specifying the name of the field to set. 
Returns: 

The value of the field 
Throws : SessionAccessException 
if there was a problem accessing the fields value. 
•getLastAccessed 

public long getLastAccessed ( ) throws RemoteException 
Get the time at which this instance was last accessed 
Returns: 

the time in milliseconds since EPOCH when this object was last accessed. 
•getLong 

piiblic long getLong (String fieldName) throws 
SessionAccessException 

Get the value of a long integer field within the associated Sessionlmpl 

instance. 

Parameters: 

fieldName - A string specifying the name of the field to set. 
Returns: 

The value of the field. 
Throws: SessionAccessException 
if there was a problem accessing the fields value. 
•getObject 

public java.lang. Object getObject (String fieldName) throws 
SessionAccessException 

Get the value of a field within the associated Sessionlmpl instance. The 

field type must be an extension of Object and must also implement the 

Serializable interface. 

Parameters: 

fieldName - A string specifying the name of the field to set. 
Returns: 

The value of the field. 
Throws: SessionAccessException 
if there was a problem accessing the fields value. 
•hasExpired 

public boolean hasExpired {) throws RemoteException 
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Determine if this object has expired 
Returns: 

true if the object has expired, false otherwise. 
•sessionFailurc 

protected void sessionFai lure (Exception e) throws 

SessionAccessException 

General exception handler for the session object 
Parameters: 

e - the exception which is being handled 
Throws: SessionAccessException 
there was a problem while accessing a field 
•sessionFailune 

protected void sessionFailure (String fieldName, 

Exception e) throws 

SessionAccessException 

General exception handler for the session object 
Parameters: 

e - the exception which is being handled 
Throws: SessionAccessException 
there was a problem while accessing a field 
•setDouble 

public void setDouble (String fieldName, 

double value) throws 

SessionAccessException 

Set the value of a double precision floating point field within the 

associated Sessionlmpl instance. 

Parameters: 

fieldName - A string specifying the name of the field to set. 
value - The value to set the field to. 
Throws: SessionAccessException 
if there was a problem accessing the fields value, 
•sednt 

public void setint (String fieldName, 

int value) throws SessionAccessException 

Set the value of an integer type field within the associated Sessionlmpl 

instance. 

Parameters: 

fieldName - A string specifying the name of the field to set, 
value - The value to set the field to. 
Throws: SessionAccessExcepuon 
if there was a problem accessing the fields value. 
•setLong 
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public void setLong (String fieldName, 

'long value) throws SessionAccessException 
Set the value of a long integer field within the associated Sessionlmpl 
instance. 
Parameters: 

fieldName - A string specifying the name of the field to set. 
value - The value to set the field to. 
Throws: SessionAccessException 
if there was a problem accessir^ the fields value. 
•setObject 

public void setObj ect (String fieldName, 

Object value) throws 

SessionAccessException 

Set the value of a field within the associated Sessionlmpl instance. The 
field type must be an extension of Object and must also implement the 
Seriafcable interface. 
Parameters: 

fieldName - A string specifying the name of the field to set. 
value - The value to set the field to. 
Throws: SessionAccessException 
if there was a problem accessing the fields value, 
•touch 

public void touch {) throws RemoteException 

Mark the time when this object was last accessed as now. 
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Class muttiserv.sessionmgr.N€»tificationData 

Object 
I 

+ multiserv. sessionmgr .Notif icationData 

public class NotificationData 

extends Object 

implements SessionNotification , Serializable 

Provides an implementation of the SessionNotification interface 

ConsPrfiePor 

v multi$erv.$css!onmgnNotificationData (inL String, Session) 
•rcasonO 

Returns an integer code representing the reason for the notification. 
•sessionldO 

Returns a string giving the session id for the Session object which caused 
the notification to be issued 
♦ sessionObj O 

Returns a reference to a copy of the Session object which this 
NotificationData instance relates to. 

Coffsprucpors 

^ NotificationData 

public Notif icationData {int code, 

String id, 
Session sess) 

•rcason 

public int reason ( ) 

Retums an integer code representing the reason for the notification. In 
general, these integer codes will be application dependent 

•sessionid 

public java.lang. string sessionldO 

Returns a string giving the session id for the Session object which caused 
the notification to be issued. This will retum null if the notification is not 
connected with any Session object. 
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•sessionObj 

public multiserv.sessionmgr. Session sessionObj () 

Returns a reference to a copy of the Session object which this 
NotificationData instance relates to. For example, if this is a session expiry 
notification then this method will retum a reference to a copy of the 
Session object which w^s removed from the Session Manager. 
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Class multiserv.sessionmgr.ObserverMap 



Object 

I 

+ Dictionary 

+ Hashtable 

+ multiserv. sessionmgr .ObserverMap 

pubKc class ObserveiMap 
extends Hashtable 

The ObserverMap class stones the currently actice SessionObserver instances 
within the session manager. 

CoHsPruePor lude^ 

^ multiserv^sessionmgnObsen^erMap O 
^ multis e rv\ se s s ionmgnObs c rv^e rMap (int) 
^myitis e rv. s e s s io nirtg r. Obs e n^e rMa p (int, float) 

/^ephod /ffdeK 

♦ putObs e n^e r (String) 

Insert an observer object within the map using the remote entity id string 

as the key. 
»re move Obs e n^e r (String) 

Remove an obsen^er object from the map. 

Coffsprucpors 

-rf Observe rMap 

public ObserverMap { ) 

-^ObserveiMap 

public ObserverMap (int capacity) 
-^ObserverMap 

public ObserverMap ( int capacity, 

float loadFactor) 

M^P^ods 

•putObserver 

public void putObserver (String id) 
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Insert an observer object within the map using the remote entity id string 

as the key. 

Parameters: 

obs - The observer object to insert m the map. It must be implement the 
SessionObserver interface, 
id - The rcmote entity id string. 
• rcmoveObserver 

piiblic void removeObserver (String id) 

Remove an observ^er object from the map. 
Parameters: 

id - The id string for the observer to remove 
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Class muKiserVi^essionmgnSessionExpirer 



Object 
I 

+ Thread 

+ multiserv, sessionmgr . SessionExpirer 

pubKc class SessionExpircr 
extends Thread 

A thread object which expires stale session objects within the session manager at 
regular intervals. 

CoffBprficPor Mk 

^niultiserv.sessiormigr.$essionExpitier (SessiQnMgrInipr) 

• haltExpiries Q 
•runO 

CottsPr/tePors 

-^SessionExpircr 

public SessionExpirer ( SessionMgrlm pl mgr) 
•haitExpiries 

public void haitExpiries { ) 

•run 

public void run ( ) 
Overrides: 
run in class Thread 
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Class multiserv.sessionmgr.SessionldFactory 

Ob j ect 

I 

+ mult iserv , sessionmgr . SessionldFactory 

public class SessionldFactory 

extends Object 

CoffsPrtiePor Mbk 

^multisetv.sessionnignSessionldFactoiy Q 

♦ cneateSessionld Q 

Qeates a randomly generated string with NUMDIG digits, NUMLOWER 
lowercase characters, and NUMUPPER characters arranged randomly. 

ConsPrucpors 

-^SessionldFactoiy 

public SessionldFactory ( ) 

M^phods 

•crcateSessionld 

public static java.lang. String createSessionld( ) 

Creates a randomly generated strir^ with NUMDIG digits, NUMLOWER 
lowercase characters, and NUMUPPER characters arranged randomly. 
Returns: 

the randomly generated strir^ 
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Class multiserv.sessionmgr.Sessionlmpl 



Object 

+ RemoteObject 

+ RemoteServer 

I 

+ UnicastRemoteObject 

+ GenericSession 

+ 

mul t iserv . sessionmgr . Sessionlinpl 

pubKc class Sessionlmpl 

extends GenericSession 
implements SessionTags 

Contains the appKcation dependent data fields for the session. 

Yar/aHe Indent, 

» ses$_active 
• sessipaddr 
» sess_start 
•sessjLJser 

The actual Session Object members 
» sess_uscr_id 

CoMsPmcPor /j/deK 

^multlserv.sessionmgnSessionlmpK ) 

Get a new Sessionlmpl object within the session manager. 
^multiser\^.$essionmgnSe$$ionImpi (String. Long, B^Decimal, BigDecimal, 
String) 

Get a new Sessionlmpl object within the session manager. 
^ multi$erv\$essionmgr.Ses$ioaInipl (Session) 

Get a new Sessionlmpl object within the session manager. 

MePlfod /f/deK 

^ getSession f) 

Get a new Sessionlmpl object within the session manager. 
*getSession (String, Long, BigDecimal, BigDecimal, String) 

Get a new Sessionlmpl object within the session manager. 
•getSession (Session) 
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Get a new Sessionlmpl object within the session nianager. 

yariahles 

•sessactive 

protected java .math . BigDecimal sess_active 

•sessipaddr 

protected java. lang. String sess_ip_addr 

• sessstait 

protected java .math. BigDecimal sess_start 
•sessuser 

protected java . lang . String sess_user 
The actual Session Object members 

• sess_user_id 

protected j ava . lang . Long sess_user_id 

CotfsPriiepors 

^Sessionlmpl 

public Sessionlmpl 0 throws RemoteException 

Get a new Sessionlmpl object within the session manner. Gives the user 

the chance to override the default session behaviour. 

Returns: 

A string used to identify the new session in subsequent accesses to the 
session manager. 
-^Sessionlmpl 

public Sessionlmpl (String sess_user. 

Long sess_user_id, 
BigDecimal sess_start, 
BigDecimal sess_active, 

String sess_ip_addr) throws RemoteException 
Get a new Sessionlmpl object within the session manager. Gives the user 
the chance to override the default session behaviour. 
Parameters: 
sess_user - The user 
sess_user_id - The user id 
sess start - Time session was started 
sess active - Last time the session was active 
sess_ip_addr - Remote IP Address 
Returns: 

A string used to identify the new session in subsequent accesses to the 
session manager, 
-^Sessionlmpl 
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pioblic Sessionlmpl ( Session initial) throws RemoteException, 
SessionAccessException , NotSerializableException 

Get a newSessionlrr^l objea within the session manager Gives the user the chance to override the default 

session behaviour. 

Parameters: 

initial - The initial session 

Returns: 

A string used to identify the new session in subsequent accesses to the session man^^er. 

•getSession 

public static multiserv. sessionmgr. Sessionlmpl getSessionO 
throws RemoteException, SessionAccessException , 
NotSeriali zableExcept ion 

Get a new Sessionlmpl object within the session manager. Gives the user 

the chance to override the default session behaviour. 

Returns: 

A string used to identify the new session in subsequent accesses to the 
session manager. 
•getSession 

public static multiserv. sessionmgr. Sessionlmpl getSession (String 

sess_user, Long sess_user_id, 

BigDecimal sess_start ; BigDecimal sess_active, 

String sess_ip_addr) throws RemoteException, 

SessionAccessException , NotSerializableException 

Get a new Sessionlmpl object within the session manager. Gives the user 

the chance to override the default session behaviour. 

Parameters: 

sess_user - The user name 
sess_user_id - The user id 
sess_start - Time session was started 
sess_active - Last time the session was active 
sess_ip_addr - Remote IP Address 
Returns: 

A string used to identify the new session in subsequent accesses to the 
session manager. 
•getSession 

public static multiserv , sessionmgr . Sessionlmpl 
getSession ( Session initial) throws RemoteException, 
SessionAccessExcepti on , NotSerializableException 

Get a new Sessionlmpl object within the session manager. Gives the user 

the chance to override the default session behaviour. 

Parameters: 

session - Contains the initial session data. 
Returns: 
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A strir^ used to identify the new session in subsequent accesses to the 
session manager. 
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Class multiserv.sessionmgr.SessionMap 



Ob j ect 

I 

+ Dictionary 

I 

+ Hashtable 

I 

+ multiserv . sessionmgr . SessionMap 

public class SessionMap 
extends Hashtable 

The SessionMap class stores the currently active Sessionlmpl instances within the 
session man^en 

ConsPrucPor lifdey^ 

v multisery.sessioniTigr.SessionMap O 
^multiserv.sessionmgnSessioiiMap (int) 
^multis e rv. s e s s io nmg r. Se s s io iiMa p (int. float) 

MePffod lffdi\ 

» getSes$ion (String) 

Retrieve a session object from within the using the specified session id key. 
• putSession (Session. String) 

Insert a session object within the map using the session id string as the 

key 

• remove Session (String) 

Remove a session object from the map. 

ConsPrucpors 

^SessionMap 

public SessionMap 0 
-^SessionMap 

public SessionMap {int capacity) 
-^SessionMap 

public SessionMap ( int capacity, 

float loadFactor) 

•getSession 
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piiblic multiserv.sessionmgr. Session getSession (String sessionid) 
Retrieve a session object from within the usm% the specified session id key. 
Parameters: 

sessionid - The session id string. 
Returns: 

The session object if the session id is valid otherwise null 
•putSession 

piiblic void putSession ( Session session, 

String sessionid) 
Insert a session objea within the map usii^ the session id string as the 
key. 

Parameters: 

session - The session object to insert in the map. It must be a subcUss of 
GenericSession, 

sessionid - The session id string, 
•remove Session 

public void removeSes si on (String sessionid) 
Remove a session object from the map. 
Parameters: 

sessionid - The id string for the session to remove 



147 



Class 

muitisetViSesskHimgr.SessionMgrConnection 



Object 
I 

+ Thread 

I 

+ multiserv. sessionmgr . SessionMgrConnection 

pubKc class SessionMgiConnection 

extends Thread 



ConsPrHcPor ludeyt^ 

^ multi$en^ses$iomTtgr.Ses$ionMgiCormecrion (SessionMgrI^ Socket) 

Mepkod /ffdex, 

•runO 

CotisprMcPors 

-^SessionMgrConnection 

public SessionMgrConnection ( SessionNgrlmpl mgr, 

Socket clientSocket) 

•run 

public void run{) 
Overrides: 
run in class Thread 
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Class multiserv.sessk>nmgrSessionMgi1mpl 



Object 



4- RemoteOb j ect 



+ RemoteServer 



+ UnicastRemoteObject 



+ 



mul t i sejTv . se s s ionmgr . S es s ionMgr Impl 

public class SessionMgrlmpl 

extends UnicastRemoteObject 
implements SessionMgr 

The SessionMgr remote interface is used to control the session manager. 



^ multisen\$cssioningnSessionMgrImpl (String, String, String) 
Construct a new instance of SessionMgrlmpl. 



• closeSession (String) 

Remove an existing Sessionlmpl object from the session manager. 
• expineOldSessions () 
• finalize 0 

» initSession (Session) 

Create a new Sessionlmpl object within the session manager, 
•log (String) 

Write infonmation to stdout tagged with the date and time, 
» niain (StringQ) 

The main method for the session manager process. 
• notif\6e niets (int. String, Session) 
•rcgister(String) 

A remote entity registers interest in events taking place within the 

manager by calling this method 
•reload 0 
• restoreState Q 




• config 



Contains the application configuration information 
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Restores the contents of the Session map from persistent store. 
• saveState Q 

Saves the contents of the Session map to persistent store. 
• sessionJdList Q 

Retum an ana^containing all the current Session object identifiers. 
■ sessionObjName (String) 

Constructs the session object name given the session id 
• s hutdown (String) 

A remote entity informs the Session A^anager that it is prepared to have 

the Manager shutdown operations, 
• shutting do wn Q 
• trace (String) 
♦ urnie gis te r (String) 

A remote entity calls this method to stop further notifications being sent 

by the session manager. 

•config 

public multiserv. conf ig.Conf ig config 

Contains the application configuration information 

CoHsPruePors 

^ Ses s ionMgrlmpl 

public Ses s ionMgrlmpl {String rmihost. 

String name, 

String configFile) throws RemoteException, 

Mai f ormedURLExcept ion 

Construct a new instance of SessionMgrlmpL 
Parameters: 

managerName - Identifies this session manager instance 
name - The name by which the session manager will be known 
configFile - The configuration file 

M^Pffods 

•closeSession 

public void closeSession (String sessionid) throws 
RemoteException, Mai f ormedURLExcept ion, NotBoundException 

Remove an existing Sessionlmpl object from the session manager. 

Parameters: 

sessionid - A strir^ which identifies the session to be removed. 

Throws: RemoteException 

some communication problem occurred. 

Throws: NotBoundException 



150 



the session which is being closed does not have it's interface bound to the 
RMI registry. 
•expircOldSessions 

piiblic void expireOldSessionsO 
•finalize 

protected void finalize () 

Ovetxides: 

finalize in class Object 
•initSession 

public java.lang. String initSess ion (Session initial) throws 
RemoteException, Malf ormedURLException, SessionAccessExcept ion , 
NotSerializableException 

Create a new Sessionln^l object within the session manner. 
Parameters: 

session - Contains the initial session data. 
Returns: 

A string used to identify the new session in subsequent accesses to the 
session manager. 

•log 

public void log (String message) 

Write information to stdout tagged with the date and time. 
Parameters: 

message - the information to output 

•main 

public static void main (String [] args) 

The main method for the session manager process. This installs a security 
inan^er as well as creating a registry so that the clients can lookup the 
manager objects. The session manager must be started with a single 
command line argvinent. This argument specifies the session manager 
name. 

•notifyServlets 

protected void notifyServlets (int reason, 

string sid, 
Ses_sion sess) throws 

RemoteException 
•register 

public void register (String id) throws RemoteException 

A remote entity registers interest in events taking place within the session 
manner by calling this method. After this the session manager can notify 
the entity via the Servlet's SessionObserver interface. 
Parameters: 
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id - A unique string identifying the registering entity. The name should be 
an RM addressable ID. That is, you should be able to tack "rmi://" on to 
the front of it. Suggestion is "host/sen^letld" 
Throws: RemoteException 
if some communication failure occurs. 
• reload 

piiblic void reload 0 throws RemoteException 
•rcstoreState 

protected void restoreState { ) 

Restores the contents of the Session map from persistent store. 
•saveState 

protected void saveState () 

Saves the contents of the Session map to persistent store. 
•sessionldList 

public java .util .Vector sessionldList ( ) throws RemoteException 
Return an array containing all the current Session object identifiers. 
Returns: 

An Vector instance containing the Session object id's. 
Throws: RemoteException 
if some communication failure occurs. 
•sessionObjName 

protected java'. lang . String sessionObj Name (String sid) 
Constructs the session object name given the session id. 
Parameters: 

sid - the session id string for the object 
Returns: 

a string containing the session object name or the empty string if sid is 
null. 

•shutdown 

public void shutdown (String id) throws RemoteException 

A remote entity informs the Session Manager that it is prepared to have 
the Manager shutdown operations. The Session Manager will shutdown 
operation as soon as it receives shutdown notifications from all registered 
entities. 
Parameters: 

id - A unique string identifying the entity 
Throws: RemoteException 
if some communication failure occurs, 
•shuttingdown 

public void shuttingdown ( ) 
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•trace 



public void trace (String message) 

•unrcgister 

public void unregister (String id) throws RemoteException 

A rcmote entity calls this method to stop further notifications beii^ sent 

by the session manager. 

Parameters: 

id - A unique string identifying the entity. 

Throws: RemoteException 

if some communication failure occurs. 

See Also: 

register 
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Class muitisen/;sessionmgr.SessionMgrShutdown 



Ob j ect 
I 

+ Thread 

+ mul tiserv . sessionmgr . SessionMgr Shut down 

public class SessionMgrShutdown 
extends Thread 

A thread object which shuts down the SessionMgr process 

CoMsPrMcPor lndeK 

^multiserv.sessionmgnSessionMgtShutdown Q 

MePffod f/fdex. 

•runQ 

Co^sprucpors 

^ Ses s io nMgrShutdo wn 

public SessionMgrShutdown ( ) 

M^P^ods 

•run 

public void run ( ) 

Overrides: 

run in class Thread 
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Class inuittservsessionmgr.SocketHandler 



object 

I 

+ Thread 

I 

+ mult iserv . sessionmgr . SocketHandler 

pubKc class SocketHandler 
extends Thread 

A thread object which listens on a socket for connection attempts and then 
services commands from authorized clients. Normally only the host on which the 
session manager is running or the loopback device are allowed The property 
multiserv.sessionmgr,allowedIPs of IP Addresses allows other hosts access - it 
should coonsist of white space separated IP addresses. 

CoMBprucPor lude^ 

^ multis e n^.s e s s io nmg r. Soc ke tHa ndle r (SessionN%rImpQ 
Create a socket handler 

•hakO 
•rynQ 

CoHsPtfiePors 

^SocketHandler 

public SocketHandler ( SessionM g rlmpl mgr) 
Create a socket handler 
Parameters: 

mgr - Reference to the session manager instance 

M^P^ods 

•halt 

public void halt() 

•run 

public void run{) 

Overrides: 

run in class Thread 
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Class 

multiserv.sessionmgrSessionAccessException 



Object 
I 

+ Throwable 

I 

+ Exception 

+ 

raultiserv . sessionmgr . SessionAccessException 

public class SessionAccessException 
extends Exception 

This exception is thrown to indicate a problem with accessing data within a 
session object. 

CoflsPrucPor liideK 

^ multiserv.sessioningnSessionAccessException (String) 

Constructs a new SessionAccessException with the specified descriptive 
message. 

Cofisprucpors 

SessionAccessException 

public SessionAccessException (String msg) 

Constmcts a new SessionAccessException with the specified descriptive 
message. 
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package muKiserv^l 

l/fperfaee /ff^ex, 

• Watchable 

C/ass lndeK 

• Cache 

• FileCache 

• FileCacheFactory 

• FileSuffixFilter 

• HIMLCache 

• FTTN^LCacheFacton- 

• HITvILDocumem 

• Logger 

• SendAfeil 

• SoundEx 

• TimedCounter 

• Watcher 

t yt^cepPiott ludeyt, 

• CacheException 
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interface muttiserv.util.Watchable 

public abstract interface Watchable 



♦wakcup Q 
• watch Q 

•wakeup 

public abstract void wakeup ( ) 

•watch 

public abstract void watch {) 
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Class multiserv.iitil.Cache 



Object 
I 

+ multiserv.util .Cache 

public abstract class Cache 
extends Object 
implements Watchable 

yariakle //r<//?x 

. DEBUG 

CoMBpruePor 

^ mul tis e rw. util. Cac he 0 
^multis e tv. utiLCac he (long) 

J^ePhod /ffdeK 

• addObject fString, Object, long) 
•getKeysO 

Get the keys of the table rows stored in the Cache. 

•getObject(String) 

> inte rruptWatc hing 0 

• populate 0 

•reinitialize 0 

•removeAUO 

♦ re moveOb jec t (String) 

• re populate () 

• s e tWatx: he rPe lay (long)' 

• startWatching O 

• stopWatching O 

• update Object (String, Object, long) 
• wake up Q 
• watch Q 

•DEBUG 

public static boolean DEBUG 

CoffsPr/fcPors 

^ Cache 
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public Cache {) 
^ Cache 

public Cache (long sees) 
•addObject 

public synchronized void addObject (String name, 

Object obj , 
long lastModif ied) 

•getKeys 

protected synchronized java.util. Enumeration getKeys () 
Get the keys of the table rows stored in the Cache. 
Re turns: 

An Enumeration of the available keys. The keys are stored as strings. 
•getObject 

public synchronized java . lang. Object getObject (String name) 
throws CacheException 

• interruptWatching 

public void interruptWatching ( ) 

•populate 

public abstract void populate () 
•reinitialize 

public abstract void reinitialize () 

• re move All 

public synchronized void removeAll () 

• removeObject 

public synchronized void removeObject (String name) 

• rcpopulate 

public abstract void repopulateO 

• setWatcherDelay 

public void setWatcherDelay ( long sees) 

• startWatching 

public void startWatching () 

• stop Watching 

public void stopWatching () 
•update Object 
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public synchronized void updateObject (String name, 

Object obj , 
long lastModif ied) 

^ wake up 

public final synchronized void wakeupO 
Swatch 

public final synchronized void watch {) 
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Class multiserv.util.FileCache 



Object 



+ Cache 



+ multiserv . util . FileCache 



pubKc class FileCache 
extends Cache 



> ge tPoc ume nt (String) 
» main (StringQ) 
• populate f) 
•reinitialize () 
♦ repopulate Q 
• setSuffixes (StringQ) 



•getDocument 

public java.lang. String getDocument (String name) throws 

CacheException 

•main 

public static void main {String [] args) 
•populate 

public void populate ( ) 
Overrides: 

populate in class Ciche 
• reinitialize 

public void reinitialize ( ) 

Overrides: 

reinitialize in class Cache 
•iiepopulate 

public void repopulateO 

Overrides: 

repopulate in class Ciche 
•setSuffixes 
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public void setSuf fixes (String [] fileSuf fixes) 
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Class multiserv.util.FileCacheFactory 



Object 
I 

+ multiserv.util . FileCacheFactory 

public class FileCacheFactoiy 

extends Object 

CortBprucPor Inde^ 

^multis e iv. util. File Cac he Fac tory Q 

MePfiod /ffdex. 

•getCache (String) 

♦ getCache (String. String, lor^, StringQ) 

Cofisprucpors 

^ File Cac he Fac tory 

public FileCacheFactory { ) 

M^P^ods 

•getCache 

public static multiserv.util . FileCache getCache (String 
cacheName) throws lOException 

• getCache 

public static multiserv .util . FileCache getCache (String 
cacheName , 

String dir, 
long 

cachePeriod, 

String [] 

suffixes) throws lOException 
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Class muitiserv;iitil.RleSiifflxRtter 



Object 
I 

+ multiserv.util . FileSuf f ixFilter 

public class FileSuffixFilter 

extends Object 
implements FilenameFilter 

CoMsPrncPor iMdey^ 

^ multis e rw, util > F ile S uffixFilte r (StringQ) 
^ multisen^utiLFileSuffixFilter fStringn, long) 

J^eP/fod /0deK 

•accept(File, String) 

CoMsptMcPors 

> FileSuffixFilte r 

public FileSuf f ixFilter {String [] suffixes) 

^ FileSuffixFilte r 

public FileSuf f ixFilter (String [] suffixes, 

long modif iedSince) 

M^P^ods 

•accept 

public boolean accept (File dir, 

String name) 
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Class muitiserv.util.HTMLCache 



Object 
I 

+ Cache 

i 

+ FileCache 

I 

+ multiserv.util .HT^4LCache 

public class HTMLCache 
extends FileCache 
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Class muKiserv;.util.HTMLCa€:heFactory 



Object 

I 

+ FileCacheFactory 

I 

+ mul t iserv . util , HTMLCacheFactory 

public class HTMLCacheFactory 

extends FileCacheFactory 



CoMsPrMCpor 

^multiscn^.utiLHTMLCacheFactory O 

MePitod /ffdeK 

•getCache (String, String, long, StringO, Hashtable) 

ConsPtMcPors 

^HTMLCacheFactory 

public HTMLCacheFactory {) 

M^P^ods 

•getCache 

public static multiserv.util . HTMLCache getCache {String 
cacheName , 

String dir, 
long 

cachePeriod, 

String El- 
suffixes, 

Hashtable 

tokens) throws lOException 
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Class muKiserv.iitil.HTIVILDocunieiit 



Object 
I 

+ multiserv.util .HTMLDocument 

pubKc class HTMLDocument 

extends Object 

CoMsPtMCpor ludey^ 

^mulriserv,utiLHTMLDocument (String. String) 

^multis e rv. utiL HTMLDoc ume nt fString. String, Hashtable) 

^multisen\utiLHTMLDocument (String. String, Hashtable, Hashtable, boolean) 

Mephod /ffde\ 

» buildListTokens (String. String, String, Vector, Hashtable, boolean) 
» buildSimpleToke ns (Hashtable. Hashtable) 

Convenience method ^ch builds a token table to be passed to 

sendParseDocumentO- 
^ buildTokens (Hashtable, Hashtable, boolean) 

Convenience method which builds a token table to be passed to 

sendParseDocumentQ . 
•toStringO 

Cofisprficpors 

^ HTMLDoc ume nt 

public HTMLDocument (String cacheName, 

String docName) throws lOException 

^HTMLDocument 

public HTMLDocument (String cacheName, 

String docName, 

Hashtable tokens) throws lOException 

^HTMLDocument 

public HTMLDocument (String cacheName, 

String docName, 
Hashtable tokens, 
Hashtable tokenData, 

boolean checkedNameVal ) throws lOException 

M^P^ods 

^ buildListTokens 
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public static void buildListTokens (String cacheName, 

String listDocToken, 
String listDocName, 
Vector data, 
Hashtable tokens, 
boolean checkedNameVal) 

throws lOException 

• biaildSimpIeTokens 

public static void buildSimpleTokens (Hashtable data, 

Hashtable tokens) 
Convenience method which builds a token table to be passed to 
sendParseDocumentO. It basically goes through the passed Hashtable and 
builds another Hashtable where die keys are renamed as -^^ke/" - That is, 
' — is tacked on the beginning and — ' is tacked on the end of each key. 
This method could be useful for taking the data from a database query 
retumed in a hashtable and building a token table to populate an HTML 
page- 
Parameters: 

data - The incoming Hashtable 

tokens - The token table to be built. It might already contain some tokens 

- which will added to. 
•buildTokens 

public static void buildTokens {Hashtable data, 

Hashtable tokens, 
boolean checkedNameVal) 

Convenience' method which builds a token table to be passed to 
sendParseDocumentO . It basically goes through the passed Hashtable and 
builds another Hashtable where the keys are renamed as ---'^key*' — That is, 
' — is tacked on the beginning and is tacked on the end of each key. 
Special cases exist for keys starting with pvt or opt. These are treated as 
the special token types for checkboxes/ radio buttons and selection lists 
respectively This method could be useful for taking the data from a 
database queiy retumed in a hashtable and building a token table to 
populate an HTML page. 
Parameters: 

data - The incoming Hashtable 

tokens - The token table to be built. It might already contain some tokens 

- which will added to. 

checkedNameVal - If checked, build PVT tokens as @# name =value# @ 
else just as @ # name# @ 
•toString 



public java.lang.String toString ( ) 
Overrides: 
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toString in class Object 
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Class muitiserv,util.Logger 

Object 

I 

+ Thread 

I 

+ mult iserv.util .Logger 

public class Logger 
extends Thread 

A class can be used for logging. 

CoHsPrucPor Iffdey, 

^ multiser\^utiLLogger (String) 

Constructor for the Logger 

^ gctWriter Q 

» main (String[l) 

•run0 

CoHsPrHcPors 

V Logger 

public Logger (String logFile) throws lOException 
Constructor for the Logger 
Parameters: 

IpgFile - The file to which to log 
• getWriter 

public static java . io, PrintWriter getWriterO throws lOException 
•main 

public static void main (String [] argv) 
•mn 

public void run () 

Overrides: 

am in class Thread 
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Class multiserv.utii.SendMail 



Object 
I 

+ multiserv.util .SendMail 

public class SendMail 
extends Object 
implements Runnable 

This is an interim class for sending mail. Sun hava a javamail API which is still in 
Beta Test and will be available for platform independent sending of mail. I did 
download it to check it out but it required another piece of Beta software so I 
thought I would leave it for now. 

CortBprficPor lude^ 

^multis e w, utiLSe ndMail (String. String, String, String, String, String) 
^ multis e n^util.Se ndMa il (String, String, String, String, String, String, boolean) 

•niain(Stringn) 
•runQ 

CotisPtfiePors 

-^SendMail 

public SendMail (String from, 
String to, 
String cc, 
String replyTo, 
String subject, 

String message) throws lOException 

^SendMail 

public SendMail (String from, 
String to, 
String cc, 
String replyTo, 
String subject. 
String message, 

boolean mimed) throws lOException 

M^Pftods 

•main 
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public static void main (String [] argv) 
• run 

public void run() 
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Class muttiserv.iitili.SoundEx 



Object 
I 

+ multiserv.util *SoundEx 

public class SoundEx 
extends Object 

CoMsPrMCpor Ifide^ 

^multis e rv. util.SoundE x Q 
vmultis e rv. utiL SoundE x (String) 

MePftod IftdeK 

^ Calculate (String) 

Generates a soundex code for the input string. 

CoftsPruepors 

'^SoundEx 

public SoundEx 0 

-^SoundEx 

public SoundEx (String inputString) 

MePffods 

• Calculate 

public static java. lang . String Calculate (String inputString) 
Generates a soundex code for the input string. 
Parameters: 

inputString - The string that is used to generate the soundex code 
Returns: 

A string representing the soundex code. If a code cannot be generated 
then the string "XXXX" is returned 
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Class multiserv.util.Watciier 

Object 
I 

+ multiserv.util .Watcher 



public class Watcher 
extends Object 
implements Runnable 

CoMSPrficPor Ittdeyt^ 

v multis e rv.utiL Watc he r (Watchable. long) 

• interrupt 0 
•run0 
• start Q 
•stopO 

CoffsPrucpors 

^Watcher 

public Watcher ( Katchable babe, 
long sees) 

M^P^ods 

• interrupt 

public void interrupt:-() 

• run 

public void run () 

• start 

public void start () 

• stop 

public void stopO 
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Class muttiserv.utii.CacheException 



Object 

+ Throwable 

+ Exception 

I 

+ lOExcept ion 

+ multiserv.util . CacheException 

public class CacheException 
extends lOException 

CoHsPrMCpor Itide^ 

^multis e rv.utiLCac he E xc e ption Q 
^ mu iris e utiLCac he E xc e ption (String) 
^ multiseiv.utiLCacheExceptiQn (Strii^, Exception) 

MePffod IffdeK 

• getCause O 

CoMsprucPors 

^CacheException 

public CacheException ( ) 
^CacheException 

public CacheException (String reason) 

'^CacheException 

public CacheException (String reason, 

Exception e) 

•getCause 

public java . lang . Exception getCause ( ) 
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UML Diagrams 

The following UML diagrams provide a visijal description of the mteractions between 
the Java classes used by Ecardfile, 

From the high level diagram you can click on the number by the side of the class and 
be brought to the large scale di^?am* 
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EcardNotitier 



Ec<irdHotifier ^ 

-parent:CommonApplicationlnterface 

-myThread:Thread 

-cardld:long 

-eCardld:String 

-messaqeCache: String 

+EcardNotifier( CommonApplicationlnterface. String, long, String){constructor} 

+run().void 

+start():void 

+interrupt():void 

+stop():void 

+not!fyUser( Hashtable. long, long, String, HashtabIe):void 



LoginServlet 

Loj[|inSeivlet 



init( ServletConfig):void 

getApplicationlnterface():Applicationlnterface 



SearchServlet 
SeaichSeivkt 



init( ServletConfig) void 

getApplicationlnterface():Applicationlnterface 
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ApplServlet 



ApplServlet 




id: String 

m n rl\l m P ■ ri n n 

rmiHost:String 

sessionMgrSessionMgr 

sessionMgrState:int 

appl:Applicationlnterface 

currentRequests:int 

ourConfig:Config 

debuqOniboolean 




init( ServletConfig):void 

doGet( HttpServletRequest. HttpServietRe 

doPost( HttpServletRequest. HttpServletR 

setSessionMgrState( int):void 

incrCurrentCount( ):void 

decrCurrentCount( ):void 

destroy():void 

getSessionMgr( ):SessionMgr 
getProperty( String): String 
log( String):void 
trace( String):void 

getApplicationlnterface():Applicattonlnterf; 


3ponse):void 
3sponse):void 

jce 
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SearchAppiicationlnteiface 



SeiifchApplic^tionlnterface 




PUBLIC ACCESS. short 
PRIVATF ACCFFi?: <^hnrt 




SearchAppiicationlnterface( ) 

init( AppiServlet, String. String):void 

destroy():void 

notify( SessionNotification):void 

authenticateL>ser( String, String. HttpServietReques 

getCookieTag( ):String 

postAuthenticate( String. Session. HttpSenifletRequ 
executeOperation( String. String, Session, HttpSeni 
accessDenied( String, HttpServletRequest. HttpSer 
preDestroy( Stnng. Session. HttpServletRequest, H 
postDestroy( HttpServletRequest. HttpServletRespo 
searchUs8r( String, long, String, HttpServietReques 
adjustCardOetailTokens( Hashtable):void 
newUser( String. HttpSen^etRequest. HttpServletRe 
validateUserFonn( String. Session, String, HttpServ 
addUser( String. Session. String. HttpSen^ietReque 
hashVectorFromRowVector( String[], Vector, short, 
addUserConfirm( String, Session, String, HttpSen^Ie 
displayCardListFirstLastName( long. String, String, 
displayCardListFirstLastNameSoundEx( long, Strin; 
displayCard( long. String. Hashtable, int, String. Str 
displayWhereAnnl( long, long, Hashtable, short, Htti 
getCards( long, String[]. boolean):Vector 
addMultiRowTol<ens( String, short. Vector, Hashtab 
addCardToPersonaiList( DatabaseConnection2. loni 
addUserToPrivateList( DatabaseConnection2, long. 
displayCardListPersonal( DatabaseConnection2, lor 
createCardList( DatabaseConnection2, long, Hasht< 
confirmUser( String, Session, String, HttpSen^letRe 
getMultiRov^VaiuesFromFornn( HttpSen^letRequest, 
getMultiRowValuesFromForm( HttpSen^letRequest. 
getMuitiRowValuesFromForm( HttpServletRequest. 
convert MultiRowHashes( Vector, String[], int[l).Vec 
dispiayPersonalList( String, Session, HttpSenrfetRe 
displayUpdateList( String, Session, String. String, h 
displayDownloadList( String, Session, Stnng. HttpS 
downloadFile(long. HttpSen/ietRequest, HttpSer^let 
downloadFiie(iong. HttpSen/letRequest, HttpServlet 
downtoadCard( long. HttpSen/ietRequest, HttpSen/h 
sendFile( String, String, Stnng, String, Hashtable, \ 
addPersonaiList( String, Session, Stnng. HttpSen/k 
oneTimeWelcome( Stnng, Session. HttpServlietReq 
crelMeU"s"efCSlnngVSes*sro"ri ," HtlpSeWefReque'sf .'HI 
changeDetaiis( long. Session. HttpSen^let Request, 
doChangeDetails( String. Session, HttpSeo^letRequ 
notifyCardSubscribers( long, String):void 
doAddWhereAml( long. Session. HttpSen^letRequej 
doChangeWhereAml( long. Session, HttpSer^letRet 
doUpdatePlist( Stnng. Session, HttpServletRequest 
getPrivacyAccess( DatabaseConnection2, long. Ion 
gGtPrivacyAccess( DatabaseConnection2. long, Ion 
checkPrivacyAccess( short, Hashtable) void 
findPassword( String. HttpServletRequest. HttpSen/ 
checkToken( Vec1or)-Vector 
checkToken( String).Stnng 
replaceToken( Stnng. char. Stnng) Stnng 
rep!aceToken( Stnng. int, Stnng): Stnng 


):GenericSession 

3St, HttpSenrletResponse):void 

etRequest. HttpServietResponse).void 

letResponse):void 

tpServletResponse):void 

nse):void 

t, HttpSen^letResponse):votd 
sponse):void 

etRequest. HttpSen^letResponse, Hashtable) li 
5t, HttpServletResponse, Hashtable) void 
Hashtable):void 

tRequest, HttpServletResponse. Hashtable).b( 
Stnng. Hashtable. HttpSen^letResponse):boole: 
J. String, String. Hashtable, HttpServletRespor * 
ng, HttpServletResponse):boolean 
iServletRequest. HttpServletResponse). booiea ' 

e, int):void 
1, long):long 
ong. short):long 

g. String, String, String, Hashtable).boolean 

ble. String. Hashtable):boolean 

luest, HttpSen/ietResponse, Hashtable) void 

Stnng[]) Vector 

Stnng[]. String) Vector 

Stnng[-], Hashtabie) void 

or 

quest, HttpSen/letResponse, String, HashtabU; 
IttpServletRequest. HttpSen/ietResponse, Has- 
ervIetRequest, HttpSen/letResponse, Hashtabh 
=?esponse, Hashtable):void 
Response, Hashtable. boolean):void 
tResponse. Hashtable, booiean):void 
'ector, HttpSen/letResponse).void 
tRequest. HttpServletResponse, Hashtable) vc 
jest, HttpServletResponse, Hashtable):void 

fpSe'rvfelRespo"ris§*}^ashlab1eJ:¥o*^^^ " 

HttpServletResponse. Hashtable):void 

ist, HttpSen/letResponse, Hashtable):boolean 

t. HttpServletResponse. Hashtable):boolean 
uest. HttpSen/ietResponse, Hashtable):boolec 
. HttpServletResponse, Hashtable, Stnng) boo 
g); short 

g, Hashtable).void 
etResponse)boolean 
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CommonApplicationlnterface 

Co m monAp pi iciition Interface 

verboseErrors boolean 

faiiedlPAddresses TimedCounter 

htmlCache.FfleCache 

templateCache.FiieCache 

wmlCache.FiteCache 

loakupCache.LookupCache 

bannerCache.BannerCache 

connMgrJdbcConnectionBroker2 

generalErrorMsg. String 

defaultPdaPaqe String 

CommonApplicationlnterface( ) 
init( AppiSetviet. String, String) void 
reinrtO void 
destroyO void 

getUserid( HttpServietRequest) String 
getPassword( HttpServietRequest) Stnng 
getSessionld( HttpServietRequest)- Stnng 
getCookieTagO String 
getCookie{ HttpServietRequest) String 
addBannerToken( Hashtable) void 

sendLoginScreen( HttpServietRequest, HttpSetvletResponse, Stnng) void 
sendLoginScreen{ HttpServietRequest, HttpSer^letResponse. Stnng, Hashtable) void 
sendSearchScreen( HttpServietRequest, HttpSen^etResponse, Stnng, Hashtable) void 
sendSearchScreen( HttpServietRequest, HttpSenHetResponse, Stnng) votd 
sendSearchScreen( HttpServietRequest, HttpSenHetResponse) void 
operationRequiresLogin( Stnng) boolean 
isLoggedln( String. Session) boolean 

accessDenied( Stnng. HttpServietRequest, HttpSenHetResponse) void 
checkAccess( HttpServietRequest) boolean 
sessionFailure( String. HttpServietRequest)- boolean 
lockiP( Stnng) long 
!nitLockedlPaddresses( int) void 

vaiidateSession( String. Session, HttpServietRequest) boolean 
getOperation( HttpServietRequest) Stnng 
- hiddenFieid( String. Stnng) String 
getFu!!Path( Stnng) Stnng 
sendDocument( Stnng, HttpSer^etResponse) void 
sendParseDocument( Hashtable, Stnng. HttpServietResponse) void 
sendParseDocunnent( Hashtable, Stnng. String. HttpServietResponse) void 
sendParseTextFiie( Hashtable, Stnng, Stnng, HttpServletResponse)-void 
sendParseTextFile( String, String, Hashtable, Stnng. Stnng, HttpServietResponse) void 
sendParseTextFile( Stnng, Hashtable, String, Stnng, HttpServietResponse) void 
checkPrivacyAccess( DatabaseConnection2, long, long, Hashtable) short 
cardDownioadUri( Hashtable) void 

sendError( HttpServietRequest, Stnng, Stnng. HttpSen^ietResponse) void 
sendError( Stnng, Stnng, Stnng, HttpServietResponse) void 
sendError( Hashtable. Stnng, String, HttpServietResponse) void 
sendError( Hashtable. Stnng. Stnng. Stnng. HttpServietResponse) void 
sendMessage( Stnng, Stnng. HttpServietResponse) void 
sendlVlessage( Stnng. Hashtable, Stnng, HttpServietResponse) void 
sendMessage( Stnng. Stnng, Hashtable. Stnng, HttpServietResponse) void 
unknownOperatfon( HttpServietRequest, HttpServietResponse) void 
db_error( HttpServietRequest, HttpServietResponse) void 
db_error( HttpServietRequest, HttpServietResponse, String) void 
nfe_error( HttpServietRequest. HttpServietResponse) void 
nfe__error( HttpServietRequest. HttpSenHetResponse, Stnng) void 
sae_error( HttpServietRequest, HttpServietResponse) void 
re_error( HttpServietRequest. HttpServietResponse) void 
doc_access_error( HttpServietRequest, HttpServietResponse) void 
io_error( HttpServietRequest, HttpServietResponse) void 
nse_error( HttpServietRequest, HttpServietResponse) void 
verboseError( Stnng) Stnng 

getServletlmgBtnParameter( HttpSenvietRequest) Stnng 



182 



LoginApplicationliitefface 

* I 

Lo<|iriApplic<ttionlnteffa€e 



LoginApplicationlnterface( ) 

init( ApplServlet. String, String);void 

notify( SessionNotification):void 

authenticateUseit String. String. HttpSeryletRequest):GenericSession 
getCookieTag( ):String 

postAuthenticate( String. Session. HttpServletRequest, HttpSen^letResponse):void 
executeOperation( String. String, Session, HttpSeivletRequest. HttpSen^letResponse):void 
accessDenied( String, HttpServletRequest. HttpSen^letResponse):void 
preDestroy( String. Session. HttpServletRequest, HttpServletResponse):void 
postDestroy( HttpSen/letRequest, HttpServIetResponse):void 
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Applicationlnteriace 



Applicationlnterf^ice 

servletiApplServlet 

ourTimeZoneTimeZone 

ApplicationlnterfaceO 

■ iRk(ApplSer^tet--Str-iRg-5tr-iRg):-vcHd - 

destroy();void 
getProperty( String): String 
getTimeZone( ):TimeZone 
trace( String);void 
log( String):void 

notify( SessionNotification):void 

chainRequest( String, HttpServletRequest, HttpServ!etResponse):void 
getSefv!etParameter( HttpServletRequest. String): Stririg 
getServietParameterValues( HttpSen/letRequest, String):String[] 
getUserld( HttpSen^letRequest):String 
getPassword( HttpServletRequest): String 

authenticateUser( String, Stnng, HttpServletRequest):GenencSession 
getSessionld( HttpServletRequest):String 

accessDenied( Stnng, HttpServletRequest, HttpServletResponse).void 
' postAuthenticate( String. Session, HttpSen^letRequest, HttpSen^letResponse):void 
getOperatton( HttpSen^letRequest):String 
checkAccess( HttpSen/letRequest):boolean 
sessionFaiiure( String, HttpSen/letRequest):boolean 
validateSession( String. Session, HttpServletRequest). boolean 

executeOperation( String. String, Session, HttpServletRequest. HttpServietResponse):void 

preDestroy( Stnng, Session. HttpServletRequest, HttpServietResponse) void 

postDestroy( HttpServletRequest, HttpSen/letResponse):void 

sendError( HttpSen^letRequest. String. String, HttpServietResponse) void 

unknownOperation( HttpServletRequest. HttpServletResponse):void 

db__error( HttpServletRequest. HttpServietResponse):void 

db_error( HttpServletRequest, HttpServietResponse, String) void 

nfe_error( HttpSen/letRequest. HttpServtetResponse):void 

nfe_error( HttpSen^letRequest. HttpServietResponse. Stnng) void 

sae_error( HttpServletRequest. HttpServietResponse). void 

re_error( HttpSenrletRequest. HttpServietResponse) void 

doc_access_error( HttpServletRequest. HttpServletResponse):void 

io_error( HttpSen/letRequest. HttpServletResponse)'void 

nse_error( HttpSen/letRequest, HttpServletResponse):void 
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CommonConfig 
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DatabaseConnectk>n2 



DatabtiseConnectioriZ 



szClass:Strjng 

DEBUG:boolean 

userUser 

address:Address 

emai!:Email 

phone:Phone 

personalList:PersonalList 

privateList: PrivateList 

whereAml:WhereAml 

lookup-Lookup 

lockedlP:LockedlP 

bannerBanner 

szClassMethodiStrinq 



DatabaseConnection2( ) 

DatabaseConnection2( String, String. String) 

getlnstance( String. String, String) JdbcConnection 

lnitialize():void 

close( ):void 

User():User 



Address 



Address 



szClass:Stnng 

table'String 

columnNames:Stnng[] 

columnLength.int[] 

columnTypes:int[] 

psByUserldiPreparedStatement 

Address( Connection) 



Banner 



Banner 



szClass:String 

table:Stnng 

coiumnNamesString[] 

columnLength:mt[] 

CQlumnTvpes:int[] 



Banner( Connection) 
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UserObject 

Us^rObjecT 



szClass:String 

psByUserldiPreparedStatement 
psDeleteBvUserld:Prepared5tatement 



UserObject( Connection. String. String[], int[], int[]) 
QueryByUserld( long)'Vector 
QueryByUs.erld{ int):Vector 
lnsert(iong, String[|):long 
Update( long. String[]):long 
DeleteByUserld( long): long 



WhereAmI 



WhereAml 



szClass:String 

table:String 

columnNames:String[] 

columnLength:int[] 

colunnnTypes:int[] 

psByUserldWithDate:PreparedStatement 
psBvExpiryiPreparedStatement 



WhereAml( Connection) 
GetWithDate( long):Hashtable 
QueryByExpiry( long, String):Vector 
Update( long. String[]):long 
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inactiveUser 



InacTiveUser 

szClassString 

table;String 

colunnnNames:String[] 

columnLength:int[] 

columnTypes:int[] 

psByECardldAndSessionld:PreparedStatement 

psByECardld: PreparedStatement 

lnactiveUser( Connection) 
Get( String. String):Hashtable 
Get(String):Hashtable 

lnsert( InactiveDatabaseConnection, String[], Vector, Vector, Vector):long 
Update( InactiveDatabaseConnection. Stringf], Vector, Vector, Vector):long 
Delete( InactiveDatabaseConnection, long):int 



User 

User 

szClassiStnng 

table:String 

columnNames:String[] 

columnLength:int[] 

columnTypes:int[] 

psByECardld:PreparedStatennent 

psByFirstLastNanne: PreparedStatement 

psByFirstLastNameSoundEx:PreparedStatenaent 

psByFirstName. PreparedStatement 

psByLastName. PreparedStatement 

psByLastNameSoundEx: PreparedStatement 

psByECardldPassword: PreparedStatement 

csConfirmUser: CallableStatement 

MAX ROWS:int 

User( Connection) 
Get(Stnng):Hashtable 
■ GetForLogin( Stnng. String):Hashtable 
QueryByFirstLastName( String. String): Vector 
QueryByFirstLastNameSoundEx( String. String); Vector 
lnsert( DatabaseConnection2, Stnng[]. Vector, Vector, Vector);long 
Update( DatabaseConnection2, Stnng[]. Vector, Vector, Vector) long 
Delete( DatabaseConnection2, long):int 
ConfirmUser( String, String)'int 
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Phone 



Phone 

szCiassiString 

table:String 

columnlMames:String[] 

columnLength:int[] 

cQlumnTvpes:int[] 

Phone( Connection) 



Userfnfo 

User Info 

szClass:String 

table:String 

columnNames:String[] 

columnLength:int[] 

columnTypes:int(l 

psByCategoryiPreparedStatement 

Userlnfo( Connection) 

QueryByCategory( long, short) Vector 

Update( long. Vector):long 



BannerCache 

BnnnerCache 

cacheKeys:Vector 

randomness. Random 

BannerCache( JdbcConnectionBroker2, long) 
BannerCache() 

getJdbcObject( Connection): JdbcObject 

populate():void 

getRandomAd( ): String 



EMail 

Em*^il 

szClass:String 
tabie:String 
columnNames:String[] 
columnLength int[] 
columnTvpes:int[1 
Email( Connection) 
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InactiveAddress 



In^ctiveAddress 

szClass:String 

table. String 

columnNames:String[] 

columnLength:int[] 

columnTypes:int[] 

psByUserldiPreparedStatement 

lnactiveAddress( Connection) 



InactiveDatabaseConnection 

InactiveDomb^iseConnecTion 

s2Ciass:String 

DEBUG:boolean 

connect:Connection 

userlnactiveUser 

address' InactiveAddress 

email:lnactiveEmail 

phone:lnactivePhone 

lnactiveDatabaseConnect!on( Connection) 
lnactiveUser().lnactiveUser 
lnactiveAddress():lnactiveAddress 
lnactiveEmail( ): InactiveEmatI 
lnactivePhone() InactivePhone 



InactivePhone 

InocTivePlione 

szClass:Stnng 
table:String 
columnNames:String[] 
colunnnLength:int[] 

columnTvpes:int[] 

lnactivePhone( Connection) 



Lookup 

Lookup 

szClassiString 
table:Stnng 
columnNannes String[] 
columnLength int[] 
columnTypes.intfl 
Lookup( Connection) 
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InactiveEman 





InacttveEmail 


szClass:String 

table:String 

columnNames:String[] 

columnLength:int[] 

columnTvpesiintfl 


lnactiveEmail( Connection) 


LockedIP 




LockedIP 


szClassiString 

tabie:String 

coiumnNames:String[] 

columnLength:int[] 

columnTypes:int[l 

psAlhPreparedStatement ' 


LockedlP( Connection) 
QueryAII():Vector 



LookupCache 

LooktipC«iche 

byCategory:Hashtable 
ADDRESS:Short 
PHONE:Short 
EMAILShort 

USERINFQ:Short 

LookupCache( JdbcConnectionBroker2 , long) 
LookupCacheO 

getJdbcObject( Connection):JdbcObject 
populate():void 

addLookupTokens( Short, Hashtable):void 
replaceLookupTokens( Short, String, int, Hashtable):void 
addVcardTokens( Short. i-lashtable):void 
replaceVcardTokens( Short, String, int, Hashtable):void 
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Personal List 



PersonalList 



szClass:String 

table:String 

columnNames:String[] 

columnLength:int[] 

columnTypes:int[] 

pslsCardThere:PreparedStatement 

psJoinByUsersld:PreparedStatement 

psContainsCard:PreparedStatement 

psJoinByUsersldName:PreparedStatement 

psDeleteBvCardid:PreparedStatement 



PersonalList( Connection) 
lsCardThere( long, long):boolean 
QueryJoinByUserld( long):Vector 
QueryContainsCard( iong):Vector 
QueryJoinByUser|dName( long, char):Vector 
lnsert( DatabaseConnection2. long, long, long, short):long 
DeleteByUserld( DatabaseConnection2, long):int 
DeleteByCardld( DatabaseConnection2, iong)*int 
Delete( DatabaseConnection2. long, long):int 



PiivateUst 



Private List 



s2Class:String 

table. Stnng 

colunnnNames;String[] 

coiumnLength;int[] 

coiumnTypes:int[] 

psGetMask:PreparedStatement 

psUpdateMask:PreparedStatement 

psDeleteByCardidPreparedStatement 



PrivateList( Connection) 
Get(long, long):Hashtable 
UpdateMask( long, short) long 
DeleteByCardld( long):long 
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TimedCounter 

TimedCoiinter 

counters:Hashtable 
period:long 

maxCount:int 

TimedCounter( long, int) 
increment( Object): int 
checkMaxCount( Object):boolean 
getCount( Object): int 
setCount( Object. int):int 
main( String[]):void 



Timed Item 

Tim^dltem 

tinneoutTime:long 

CQunt:int 

TimedltemO 
Timedltem( int) 
increment():int 
^ getCount():int 
setCount( int): int 
reset():void 



Timing 

TimilKJ 

start. long 
TinningO 

LogTiming( String) void 



Logger^ 

Loj[j(jei 

myLQgFile:Stnng 
nny Writer: PrintWriter 

pin:PipedReader 

Logger( String) 
run( )-Void 

getWriter()PnntWriter 
main( String). void 



Config 

I Confijtj 



Config( String) 
Config( Properties. String) 
- loadConfig( Stnng) void 
nnain( Stnng):void 



ConfigExceptfon 

ConfigException 

cause:Exception 

ConfigExceptionO 
ConfigException( String) 
ConfigException( Exception) 
ConfigException( String, Exception) 
getCause():Except!on 



JdbcObject 

J<lbcObject 

szClass:String 

tableiString 

columnNames:String[] 

colunnnLength:int[] 

colunnnTypes.int[] 

DEBUG;boolean 

COLUMNS:int 

COLUMNS_INSERT:int 

VALUES, int 

UPDATES:int 

INSERTS:int 

ps:PreparedStatement 

psByld:PreparedStatement 

pslnsert:PreparedStatement 

psUpdate:PreparedStat8nnent 

psUpdateCheck:PreparedStatement 

psDelete:PreparedStatement 

psMaxld:PreparedStatement 

psAILPreparedStatennent 

cQnnect:Connection 

JdbcObject( Connection. String. String[]. int[]. int[]) 

Get( long):Hashtable 

Get():Hashtable 

Query( ):Vector 

Query All():Vector 

lnsert( String[]):long 

Update(long. String[]):long 

UpdateCheck( long, long, String[]):long 

UpdateRow( String[]);long 

DeiGte( long) long 

Execute().long 

getNextld():long 

getRow( ResultSet. ResuitSetMetaData. tnt):Hashtable 

getColumnNannes( ):Stnng[] 

getCo!umnTypes() int[] 

getColumnString( int).Stnng 

TableName():String 
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JdbcConnection 



JdbcConnection 

debug:boolean 

connectiConnection ^ 

JdbcConnectionO 

JdbcConnection( String, String. String) 
lnitialize():void 

getlnstance( String. Strir>g, String): JdbcConnection 
Connect( String. String. String):booiean 
isClosed():bootean 
close():void 

getConnection():Connection 
getWarnings( ):SQLWarning 
clearWarnings():void 
createStatement( ):Statennent 
toString(): String 



JdbcConnectionFactory 

J{|bcConnectionF«icTory 

dummyConnection:JdbcConnection 

URLString 

username:String 

password: String 

JdbcConnectionFactory( JdbcConnection, String. Stnng. String) 

getConnection( ): JdbcConnection 
I _ 

JdbcVendor 

JdbcVendof 

SUPPORTJD:boolean 
DUP_VALUE:int 

PUP INDEX: int 

getld( PreparedStatement) long 
setLockModeWait( Connection. int):boolean 
knownError( SQLException):boolean 
duplicatelndex( SQLException):bootean 



FiieSuffbcFilter 

PileSuffixFilter 

suffixes:String 

modifiedSince:lonq 

FileSuffixFilter( String) 
FileSuffixFilter( String, long) 
accept( File, Stnng). boolean 
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Sound Ex 



SoiindEx 

originalString:String 
soundExCodes: Hashtable 
AreCodesSet:bQolean 
SoundEx() 
SoundEx( String) 
Calculate( String):String 
isValid(String):boolean 
collapse( String): String 
setupCodes():void 
getSoundCode( char):short 



CacheExceptkMi 

C4icheException 

cause:Exception 

CacheExcept!on() 
CacheException( String) 
CacheException( String. Exception) 
getCause():Exception 



JdbcException 

JdbcException 



JdbcExceptionO 
JdbcException( Stnng) 
JdbcException( Stnng. String, int) 
isDuplicateValue( ):boolean 



SendMan ^ 

Sendfvliiil [ 

thread. Thread 

process:Process 

mailWriterPrintWriter 

from: String 

to. Stnng 

cc. String 

replyTo. String 

subject* String 

messageStnng 

mimed:boolean 

SendMail( String. Stnng. String, String. String. String) 
SendMail( String. Stnng, String, String, String, String, boolean) 
run( ) void 

quotedPnntableEncoding( Stnng) String 
nnain( String) void 
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SesskxiTable 



SessionTiible 



getSession( String)' Session 
putSession( Session, String):voici 



ApplServlet ^ 

ApfilServkt 

id:String 
mgrNameiString 
. rnniHost: String 
sessionMgrSessionMgr 
sessionMgrState:int 
appl:Applicationlnterface 
currentRequests:int 
ourConfig:Config 

debuqOn:boolean ^ 

init( ServletConfig):void 

doGet( HttpSen^letRequest. HttpSetvletResponse):void 

doPost( HttpServletRequest, HttpSetvletResponse):void 

setSessionMgrState( int):void 

incrCurrentCount( ):void 

decrCurrentCount():void 

destroyO void 

getSessionMgr( )-SessionMgr 
getProperty( Stnng)- String 
log( Stnng) void 
trace( String):void ' 

getApplicationlnterface():Applicationlnterface 



FileCacheFactory 

FileGicheFactory 

myC'ach es:Hashtable _ 

getCache( String. Stnng. long, String[]):FileCache 
getCache( String):FileCache 
retrieveDocument( String. Strihg):Stnng 



HTMLCacheFactory 

HTrvlLCacheFactory 

getCache( String. String, long. Stnng[], Hashtable).HTMLCache 
retrieveDocument( String. String)' String 
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RequestHandler 

Reqii^stHorxHei 

CREATE String 
DESTROY.String 
rmiHost:String 
managerName String 
servIet.App I Sennet 
appllnterface Applicationlnterface 
operation. String 
request* HttpServletRequest 

response: HttpServietResponse ^ 

RequestHandier( Stnng. String, ApplServlet. Applicationlnterface. HttpServletRequest. HttpServietResponse) 
handleO void 

sessionMgr( ).SessionMgr 

sessionObjNanne( String). String 
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Appiicationlnterface ^ , 

Applicationlnterface 

servlet:ApplSeiviet 

ourTimeZoneiTimeZone _ 

ApplicationinterfaceO 

init( ApplServlet. String. String):void 

destroy( ):void 

getProperty( String): String 

getTimeZone( ):TimeZone 

trace( String):void 

log( String):void 

notify( SessionNotification):void 

chainRequest( String. HttpSen^letRequest. HttpServletResponse):vbid 
getServletParameter( HttpServletRequest. String):String 
getServletParameterValues( HttpSetvletRequest. String):String[] 
getUser!d( HttpServletRequest): String 
getPassword( HttpServletRequest): String 

authenticateUser( String, String, HttpSen/ietRequest):GenericSession 
getSessionld( HttpServletRequest): String 

accessDenied( String. HttpServletRequest, HttpServletResponse) void 
postAuthenticate( String. Session. HttpServletRequest. HttpServletResponse):void 
getOperation( HttpServletRequest): Stnng 
checkAccess( HttpServletRequest):boolean 
sessionFailure( String, HttpServletRequest): boolean 
validateSession( String. Session. HttpServletRequest): boolean 

executeOperation( String. String, Session. HttpServletRequest, HttpSeivletResponse) void 

preDestroy( String, Session. HttpServletRequest, HttpServletResponse):void 

postDestroy( HttpServletRequest, HttpServletResponse):void 

sendError( HttpServletRequest. String, Stnng. HttpServletResponse):void 

unknownOperation( HttpSen^letRequest, HttpServletResponse) void 

db_error( HttpServletRequest. HttpServletResponse):void 

db_error( HttpSen/letRequest. HttpServletResponse. String):void 

nfe_error( HttpServletRequest. HttpSen/letResponse):void 

nfe_error( HttpServletRequest. HttpServletResponse. String):void 

sae_error( HttpServletRequest. HttpSen/letResponse):void 

re_error( HttpServletRequest, HttpServietResponse):void 

doc_access_error( HttpServletRequest. HttpSeivletResponse) void 

io_error( HttpServletRequest. HttpServletResponse):void 

nse_error( HttpServletRequest . HttpServletResponse):void 
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TabteCache ^ 

TableCache 

connMgr:JdbcConnectionBroker2 

TableCacheO 

TableCache( JdbcConnectionBroker2) 

TableCache( JdbcConnec.tionBroker2. long) 

setConnManager( JdbcConnectionBroker2):void 

getJdbcObject( Connection): JdbcObject 

populate():void 

getRow( long):Hashtable 

repopulate():void 

reinitialize():void 



Watehable 



watch{):void ! 
wakeup( ):void\ 



Cache 

Cache 

cache:Hashtable 
cacheWatcher: Watcher 
watcherDelay:long 

DEBUG:bQQlean 

CacheO 

Cache( long) 

populate()void 

repopulate()void 

reinitialize():void 

watch():void 

wakeup():void 

createWatcher( long):votd 

startWatching().void 

stopWatching()void 

interruptWatching( ):void 

setWatcherDelay( long):void 

getObject( String) Object 

getKeys( ):Enumeration 

addObject( String, Object. long) void 

removeObject( String):void 

removeAIIQ.void 

updateObject( String. Object, long):void 
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JdbcConnectionBroker2 



J^lb€Conn^€tionBfi>kei2 

runnerThread 

connFactoryJdbcConnectionFactory 

connPool.JdbcConnection[] 

connStatus:int[] 

now;java.utiLDate 

connLockTime:long[J 

connCreateDate:long[] 

conn!D:String[] 

dbDiiver: String 

logFileString:String 

currConnections:int 

connLast.int 

minConns.int 

maxConns.int 

maxConnMSec.-int 

log:PrintWriter 

currSQLWarningiSQLWarntng 

randomness:RandQm 

JdbcConnectionBroker2( String, String, String. String, JdbcConnection, int, int, Stnng, double) 

runO'void 

interrupt()'void 

getConnection( ):JdbcConnection 
idOfConnection( JdbcConnection); int 
fre8Connection( JdbcConnection):String 
getAge( JdbcConnection):long 
createConn( PnntWnter, int) void 
reiease() void 
destroy():void 



HTMLCache 

HTMLCiche 

tokens:Hashtable 

HTMLCache( String, long, String. Hashtable) 
getFileContents( File): String 
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HTMLDocument 



HTMLDocumenT 

theDocument:String 

myCache:FileCache 

NO_TOKEN:int 

STARTING_TOKEN:int 

lN_TOKEN:int 

ENDING_TOKEN:int 

COMPLETE_TOKEN:int 

REJECT_TOKEN:int 

LIST_TYPE:char 

OPTlON_TYPE:char 

BUTTON_TYPE:char 

BASlC_TYPE:char 

TOKEN MATE: char 

HTMLDocument( String. String) 

HTMLDocument( String, String. Hashtable) 

HTMLDocument( String. String, Hashtable. Hashtable, boolean) 

toString():String 

retrieveDocument( String, String, Hashtable): String 
parseDocument( Hashtable, String. boolean):String 
parseDocument( Hashtable. Stnng): String 
replaceToken( StringBuffer. String. Hashtable. boolean):void 
buildTokens( Hashtable, Hashtable, boolean):void 
buildSimpleTokens( Hashtable. Hashtable):void 

bui!dListTokens( String, String. String. Vector. Hashtable. boolean):void 



Watcher ^ 

WoTcher 

nnyThread. Thread 

myTinneout:long 

babe:Watchable 

isRunninq boolean 

Watcher( Watchable, long) 
run():void 
, start():void 
interrupt():void 
stop():void 
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FileCache 



FikCache 

dirName:3tring 
cacheDirFile 

suffixes:Strinq 

FileCache( String) 
FileCache( String, long) 
FileCache( String, long. String) 
setCacheDirectoryC String):void 
getDocument( String):String 
populate():void 
repopulate():void 
' getFileContents(File):Strmg 
reinitialize().void 
setSuffixes( String):void 
main( String[]):void 



CacheOfaject ^ 

lastModified:long 

objiObject ^ 

CachedObject( Object, long) 
setObject( Object):void 
setLastModified( long):void 
getObject(): Object 
getLastModified():long 
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